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BASIC 8001 


INTRODUCTION 


BASIC 8001 is a single-user, conversational programming language which 
uses simple English-type statements and familiar mathematical notations 
to perform an operation. BASIC 8001 is one of the simplest computer 
languages to learn and once learned has the facility of advanced tech- 
niques to perform more intricate manipulations or express a problem 
more efficiently. 


BASIC 8001 is in incremental compiler which provides immediate translation 
and storage of user programs being input. This method decreases the 
response time of a RUN command and increases execution speed. BASIC 8001 
has provision for alphanumeric character string, I/O and string variables, 
and allows user defined functions and assembly language subroutine calls 
from user BASIC 8001 programs. 


BASIC 8001 can be run on any Intecolor 8001, Intecolor 8051 or Compucolor 
8001 with a minimum of 8K of user workspace. 


LOADING AND RUNNING BASIC 8001 


BASIC 8001 is provided in ROM and runs in ROM. BASIC 8001 is initiated by 
typing the ESC key, then the W (BASIC) key. The dialogue described below 
is printed. This is a once-only dialogue and does not occur after an ESC 
key, and E key sequence. The READY message is printed after the ESC, E key 
sequence. 


BASIC 8001 prints: 
BASIC 8001 V12/8/76 COPYRIGHT (C) 1976 BY CHARLES MUENCH 
MAXIMUM RAM ADDRESS? 


The user then types the highest RAM address that he has available or wants 
to use and then keys a carriage return. ————— 
miDdie oF FIRST RAM CARD: YSo5m 2 GS535-2OYBO = AFFF tex 23\ BYTES USED 
One extra RAM card is 49151 765535—-/6384 = BFFF hex. FOR INITIALIZATION 
Two extra RAM cards is 57343 265535— $192 = DFFFher, OF BASIC FOOI STATS. 
247 BYTES USED 


Three extra RAM cards is 65529=@9§535—"6 = FFFO hex. 
AFTER DOING ANYTHING. 


BASIC 8001 then prints the message, 
READY 


and waits for a command or program line to be typed. 

| 
If BASIC 8001 has been initialized as above but has returned to the CRT 
O.S. (by CPU Reset Key), then BASIC 8001 can be recalled without disturbing 
existing programs by typing the ESC key, then the E key. BASIC 8001 will 
then print the message READY. 


If power fails, the CPU Reset key is hit or the unit is turned off, 
the unit returns to the CRT operating mode. 


If the CPU Reset key or ESC delete keys are hit, the unit leaves 
BASIC 8001 and returns to the CRT operating mode. Any BASIC 8001 
statement program is saved and can later be recalled if BASIC 8001 
is re-entered by typing ESC, E. 


BASIC 8001 has twenty-four (24) key word program statements, thirteen 
(13) editing and command statements, eighteen (18) mathematical functions, 
nine (9) string functions and eighteen (18) two-letter error messages. 
With these command and statement capabilities, BASIC 8001 is extremely 
simple to use and yet very versatile and powerful. 


The next section provides an easy reference to BASIC 8001 capabilities. 
If the user is unfamiliar with BASIC 8001 language, then the remaining 
portion of this manual should be studied in sequence while having a 
terminal at your fingertips to run the example given. This manual 
should enable the user to become very proficient in BASIC 8001 when 
finished. Intelligent Systems Corporation and Compucolor Corporation 
have a number of BASIC 8001 programs on Floppy Tapes and are available 
at nominal prices. In addition, both companies will pay for BASIC 8001 
programs that are provided on floppy tape when properly documented and 
accepted. Enjoy your self programming in BASIC 8001! 
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BASIC 8001 


SUMMARY OF COMMANDS 


1. BASIC 8001 STATEMENTS 


The following summary of BASIC statements defines the general format for 
the statement and gives a brief explanation of its use. 


DATA value list 

DEF function (argument) = 
expression 

DIM variable (n), variable (n,m), 
variable $(n), variable $(n,m) 

END 

FOR variable=expressionl TO 

expression2 STEP expression3 

GOSUB line number 


GOTO line number 


THEN 
IF expression GOTO line number 


INPUT list 


INPUT "string"; list 


LET variable = expression 


NEXT variable 


ON X GOSUB line number list 


ON X GOTO line number list 


Used in conjunction with READ to input 
data into an executing program. 


Defines a user function to be used in 
the program. 


Reserves space for lists and tables 
according to subscripts specified after 


variable name. 


Placed at the physical end of the 
program to terminate program execution. 


Sets up a loop to be executed the 
specified number of times. 


Used to transfer control to the first 
line of a subroutine. 


Used to unconditionally transfer control 
to other than the next sequential line 


in the program. 


Used to conditionally transfer control 
to the specified line of the program. 


Used to input data from the terminal 
keyboard, promps with "?". 


Used to input data without promp character. 


Used to assign a value to the specified 
variable(s). 


Placed at the end of a FOR loop to 
return control to the FOR statement. 


Call the Xth line number subroutine 
after GOSUB. 


Branch to the Xth line number after GOTO. 


OUT I,X Causes the X BYTE to be output to port I. 


PLOT expression Sends the one BYTE result of the expression 
to the 8001 CRT. The result must be 
between O and 255 binary. 


POKE I,X Causes the X BYTE to be placed in memory 
location 0 <I 32767. If I is negative 
then address is 65536 + I. 


PRINT list Used to output data to the terminal. 

PRINT expression Prints results of expression. 

PRINT "string" Prints a character string. 

? Equivalent to the word PRINT. 

PRINT TAB(x) Used to space to the specified column. 

READ variable list Used to assign the values listed in a 
DATA statement to the specified 
variables. 

REM comment Used to insert explanatory comments into 


a BASIC 8001 program. 


RESTORE Used to reset data block pointer so the 
same data can be used again. 


RETURN Used to return program control to the 
statement following the last executed 
GOSUB statement. 


STOP Used at the logical end of the program 
to terminate execution. 


WAIT X,1I,J Causes the input port X to be read, 
exclusive OR'ed with BYTE J, and then 
AND'ed with BYTE I. The program will 
wait until the result is zero before 
continuing. 


ol tr ee 


#) — KERBNARD , FSS NP \X> > 182. No aed 


= | 
—, a Nore 
9 SF D -~PyoR> NATE Bsr . yee As ve Ai CO 
= 7 - 
ee oe —4-cCe RP NPTE INPUT UWVERTED 


2. COMMANDS 


The following key commands halt program execution, erase characters or delete 


lines. 


Key 


CTRL/J or Line Feed 


CTRL/M or RETURN 


CTRL/K or ERASE LINE 


CTRL/L or ERASE PAGE 


CTRL/Z or CURSOR LEFT 


Explanation 


Terminates program execution. BASIC 8001 
prints READY. 


Must be typed to end every line typed 
in or to indicate the end of an INPUT. 


A colon is used to separate multiple 
statements per line. 


Deletes the entire current line. 
Erases the CRT screen, but does not 
change or disturb BASIC 8001 statements 


in any way. 


Deletes the last character entered and 
echoes a cursor left. 


The following eohmands list, load, save, erase and execute the program currently 


in core. 
Command 


CLEAR 

CLEAR X Required vor STRING detaf 
List 

LIST line number 

LOAD I 

LOAD ? I 

RUN 

RUN line number 


SAVE I 
SANE Ls LORDIT. (ery ea 


/ 


Explanation 


Sets the array and string buffers to 
nulls and zeroes. 


Sets space for string variable to X 
characters normally 50 characters. 


Prints the user program currently in 
core on the list output device. 


Prints the program from the line speci- 
fied to the end. 


Does a NEW and inputs the program on track 
#I from the READER input device. 


Does not do a NEW but inputs and compares 
the program on track #I with what is 
existing in RAM Memory. 


Executes the program in the buffer area. 


Executes the program starting at line 
number specified. 


Outputs the program in core to track #1 
of the WRITE output device. 


NEW Erases the entire storage area. 


CONT Continues execution after CTRL/J is 
typed or after a STOP statement. 


The following functions perform standard mathematical operations in BASIC 8001. 


Name 
ABS (x) 
ATN (x) 


TMP 
CALL(x) THiS Be" MUST BE POKED IN AT 


24575 (Lo BYTE) and - 24574 (Hi BYTE.) 
COS (x) 
EXP (x) 
FRE(x) DOES NOT INCLUDE FRE(x4) BuTES! 


INT (x) 


INP (x) 
* LOG (x) 


PEEK(x) Sgme os POKE locations. 


RND (x) Repeal aster \A9S numbers. 


SPC(x) DISTRUCTIVE TAB(x) 


Explanation 


Returns the absolute value of x. 


Returns the arctangent of x as an angle 
in radians in the range + or - pi/2. 


Call the user machine language routine 


at location OAOOO HEX. Ager: “is 75 = IMP 
72 = Lo 
Q4s TY = tr 


Returns the cosine of x Cri 
Returns the value of e* where e=2.71828. 


Returns number of free BYTES not in use. 


Returns the greatest integer less than 
or equal to x. 


Returns a BYTE from input port 0 <x € 255. 
Returns the natural logarithm of x. 

Returns a BYTE from memory address 0¢x<32767 
or if X is negative the memory address | 


is 65536- x. 


Returns a value O to 79 current cursor 
position. 


Returns a random number between O and 1. 
Returns a value indicating the sign of x. 
Returns the sine of x radians. 

Causes x spaces to be generated. 

Returns the square root of x. 


Causes the cursor to tab to column 
number x when used in a print statement. 


Returns the tangent of x radians. 


The string functions are: 


Name 


ASC (x$) 


CHRS (x) 


FRE (x$) 


LEFTS (x$,I) 


LEN (x$) 


MIDS (x$,I,Jd) 


RIGHTS (x$,I) 


STRS (x) 


VAL (x$) 


CLEAR X 


Explanation 


Returns as a decimal number the seven-bit 
internal code for the first character of 
string (x$). 


Generates a one-character string having the 
ASCII value of x. 


Returns number of free string BYTES. 


Returns left most I characters of string 


(x$) . 


Returns the number of characters in the 
string (xS$). 


Returns J characters of string (xS) 
starting at position I. 


Returns right most I characters of string 


(x$) . 


Returns the string which represents the 
numeric value of x. 


Returns the number represented by the string 


(x$) . 

Reserves x bytes tee sfring dota. Default 
value is 5¢ byies. No single input can 
exceed 16 bytes. 


ERROR MESSAGES 


After an error occurs, BASIC 8001 returns to command level and types 
READY. Variable values and the program text remain intact, but the program 
cannot be continued and all GOSUB and FOR context is lost. 


When an error occurs in a direct statement, no line number is printed. 


Format of error messages: 


Direct Statement XX ERROR 


Indirect Statement XX ERROR IN YYYYY 


In both of the above examples, "XX" will be thé error code. The "YYYYY" 
will be the line number where the error occurred for the indirect statement. 


The following are the possible error codes and their meanings: 


ERROR CODE 


BS 


DD 


CF 


MEANING 


Bad Subscript. An attempt was made to reference a 
matrix element which is outside the dimension of the 
matrix. This error can occur if the wrong number of 
dimensions are used in a matrix reference; for instance, 
LET A (1,1,1)=Z when A has been dimensioned DIM A(2,2). 


Double Dimension. After a matrix was dimensioned, 
another dimension statement for the same matrix was 
encountered. This error often occurs if a matrix has 
been given the default dimension 10 because a statement 
like A(I)=3 is encountered and then later in the program 
a DIM A(100) is found. 


Call Function error. The parameter passed to a math 
or string function was out of range. 
CF errors can occur due to: 
a) a negative matrix subscript (LET A(-1)=0) 
b) an unreasonably large matrix subscript (732767) 
c) LOG-negative or zero argument 
d) SOR-negative argument 


e) A B with A negative and B not an integer. 


f) A CALL (X) before the address of the machine 
language subroutine has been patched in (see ¥g.7) 


g) calls to MIDS, LEFTS, RIGHTS, INP, OUT, WAIT, 
PEEK, POKE, TAB, SPC or ON...GOTO with an improper 
argument. 


ID 


NF 


OD 


OM 


OV 


SN 


RG 


US 


/0 


CN 


LS 


OS 


ST 


T™ 


Illegal Direct. You cannot use an INPUT or DEF 
statement as a direct command. 


NEXT without FOR. The variable in a NEXT statement 
corresponds to no previously executed FOR statement. 


Out of Data. A READ statement was executed but all 
of the DATA statements in the program have already 

been read. The program tried to read too much data 
or insufficient data was included in the program. 


Out of Memory. Program too large, too many variables, 
too many FOR loops, too many GOSUB's, too complicated 
an expression or any combination of the above. 


Overflow. The result of a calculation was too large 
to be represented in BASIC's number format. If an 
underflow occurs, zero is given as the result and 
execution continues without any error message being 
printed. 


Syntax error. Missing parenthesis in an expression, 
illegal character in a line, incorrect punctuation, etc. 


RETURN without GOSUB. A RETURN statement was encountered 
without a previous GOSUB statement being executed. 


Undefined Statement. An attempt was made to GOTO, GOSUB 
or THEN to a statement which does not exist. 


Division by Zero. 


Continue error. Attempt to continue a program when 
none exists, an error occurred, or after a new line was 
typed into the program. 


Long String. Attempt was made by use of the concatenation 
operator to create a string more than 255 characters long. 


Out of String Space. Save your program on paper tape 

or cassette, reload BASIC and allocate more string 

WrAee Seine cence ioc or less string variables. 
WITH CLEAR X. See Pa. 5! 

String Temporaries. A string expression was too complex. 

Break it into two or more shorter ones. 


Type Mismatch. The left hand side of an assignment 
statement was a numeric variable and the right hand 
Side was a string, or vice versa; or, a function 
which expected a string argument was given a numeric 
one or vice versa. 
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= 


al 


UF 


Undefined Function. Reference was made to a user 
defined function which had never been defined. 


J. 


BASIC 8001 ARITHMETIC 


qT. NUMBERS 


BASIC treats all numbers (real and integer) as decimal numbers--- 
that is, it accepts any decimal number and assumes a decimal point 
after an integer. The advantage of treating all numbers as decimal 
numbers is that any number or symbol can be used in any mathematical 
expression without regard to its type. Numbers used must be in the 
approximate range 10-38<¢ne10t38, 


In addition to integer and real formats, a third format is recognized 
and accepted by BASIC 8001. This format is called exponential or 
E-type notation, and in this format, a number is expressed as a 
decimal number times some power of 10. The form is: 


xXxXEn 


where E represents "times 10 to the power of"; thus the number is 
read "xx times 10 to the power of n". For example: 


23.4E2=23.4*102 = 2340 


Data may be input in any one or all three of these forms. Results 
of computations are output as decimals if they are within the range 
-O1 n 999999; otherwise, they are output in E format. Numbers are 
stored up to 24 bits of significance. If a number with more than 
24 bits is entered, it is truncated and stored as 24 bits. BASIC 
8001 handles six significant digits in normal operation and prints 
6 decimal digits as illustrated below: 


Value Typed In Value Output by BASIC 8001 
-O1 OL 
. 0099 9. IO000E-03 
999999 999999 
1000000 1. O00000E+06 


BASIC automatically suppresses the printing of leading and trailing 
zeroes in integer and decimal numbers, and, as can be seen from the 
preceding examples, formats all exponential numbers in the form: 


(sign) xX.xxxxxE(+ or -)n 
where x represents the number carried to six decimal places, E stands 
for "times 10 to the power of", and n represents the exponential value. 


For example: 


-3.47021E+08 is equal to -347,021,000 
7.26000E-04 is equal to .00726 


Floating point format is used when storing and calculating most numbers. 
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NOTE 


Because core size limitations prohibit the storage of 
infinite binary numbers, some numbers cannot be expressed 
exactly. In BASIC 8001, accuracy is approximately 5-% 
digits, and errors in the 6th digit can occur. For 
example, .999998 as a result of some functions may be 
equal to 1. Discrepancies of this type are magnified when 
such a number is used in mathematical operation. 


Ti. VARIABLES 


A variable in BASIC 8001 is an algebraic symbol representing a number, and 
is formed by a single letter, a letter optionally followed by a single 
digit or by double letters. For example: 
NOTE: Variables ma be a string of characters Many long 

Acceptable Variables Unacceptable Variables 
ACCEPTABLE = 80] 
TI 


Leng variables are 


f 2C-a digit cannot begin a variable. 
very usesul for inhecant 


EXCLUDES ANYTHING 
B3 |wHicn RESEMBLES 
A BASIC COMMAND 


LEETMOST 
Oe RTE AS ARE 
SIGNIF\GANT: 
DALE =64 

Subscripted and string variables are described in later sections. The 
user may assign values to variables either by indicating the values in 
a LET statement, or by inputting the values as data; these operations 
are discussed in another chapter. 


ll-numbers alone cannot form a 
variable. 


documentation in oO 
program _ 


The value assigned to a variable does not change until the next time a 
statement is encountered that contains a new value for that variable. 
All variables are set equal to zero (0) when the RUN command is issued. 
It is only necessary to assign a value to a variable when an initial 
value other than zero is required. However, good programming practice 
would be to set variables equal to 0 wherever necessary. This ensures 
that later changes or additions will not misinterpret values. 


LED. SUBSCRIPTED VARIABLES 


In addition to the simple variables described in the preceding section, 
BASIC 8001 allows the use of subscripted variables. Subscripted variables 
provide additional computing capabilities for dealing with lists, tables, 
matrices, or any set of related variables. In BASIC 8001 variables are 
allowed from 1 to 31 subscripts. 


The name of a subscripted variable is any acceptable BASIC 8001 variable 
name followed by one or more integer expressions in parentheses within 
the range 0-32767. For example, a list might be described as A(I) where 
I goes from 0 to 5 as shown below: 


A(O),A(1) ,A(2) ,A(3) ,A(4) ,A(5) 
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This allows reference to each of the six elements in the list, and can 
be considered a one dimensional algebraic matrix as follows: 


A two-dimensional matrix B (I,J) can be defined in a similar manner: 
B(0;0);,B(0;,1),B(0;2) 46 «» «=,BlOD);. — «,B(E;d) 


and graphically illustrated as follows: 


B(I,0) Bul 1) B(I,2) B(I,3) 


Subscripts used with subscripted variables throughout a program can be 
explicitly stated or be any legal expression. If the value of the expression 
is non-integer, the value is truncated so that the subscript is an integer. 


It is possible to use the same variable name as both a subscripted and 
unsubscripted variable. Both A and A(I) are valid variables and can be 
used in the same program. The variable A has no relationship to any 
element of the matrix A(I). BASIC 8001 will accept the same variable 
name as both a singly and a doubly subscripted variable name in the same 
program. 


Character strings may also be subscripted variable arrays, and may have 
the same variable name i.e., AS$(I). 


A Dimension (DIM) statement is used with subscripted variables to define 
the maximum number of elements in a matrix. ("Matrix" is the subscripted 
variable.) The DIM statement is discussed in a later paragraph. 


If a subscripted variable is used without appearing in a DIM statement, 
it is assumed to be dimensioned to length 10 in each dimension (that 
is, having eleven elements in each dimension, O through 10). However, 
all matrices should be correctly dimensioned in a program. 


IVs EXPRESSIONS 
An expression is a group of symbols which can be evaluated by BASIC 8001. 
Expressions are composed of numbers, variables, functions, or a 


combination of the preceding separated by arithmetic or relationai 
operators. 


The following are examples of expressions acceptable to BASIC 8001: 
Arithmetic Expressions String Expressions 


4 AS+B$+"ABC" 
A7* (BA2+1) 


Not all kinds of expressions can be used in all statements, as is 
explained in the sections describing the individual statements. 


Vis ARITHMETIC OPERATIONS 


BASIC 8001 performs addition, subtraction, multiplication, division and 
exponentiation. Formulas to be evaluated are represented in a format 
Similar to standard mathematical notation. The five operators used in 
writing most formulas are: 


Symbol 

Operator Example Meaning 
OR Logical and bitwise "OR" 
AND Logical and witwise "AND" 
NOT Logical and bitwise "NOT" 
+ A+B Add B to A 
- A-B Subtract B from A 
i A*B Multiply A by B 
/ A/B Divide A by B 
A ANB Exponentiation (Raise A to 


the Bth power) 


Unary plus and minus are also allowed, e.g., the - in -A+B or the + in 
+X-Y. _ Unary plus is ignored. Unary minus is treated as a zero minus 
the variable, e.g., -A+B would be handled as O-A+B. 


VI. PRIORITY OF ARITHMETIC OPERATIONS 


When more than one operation is to be performed in a single formula, as 
is most often the case, rules are observed as to the precedence of the 
operators. 


15: 


In any given mathematical formula, BASIC 8001 performs the arithmetic operations 
in the following order of evaluation: 


1. Parentheses receive top priority. Any expression within 
parentheses is evaluated before an unparenthesized expression. 


2. In the absence of parentheses, the order of priority is: 
2. Exponentiation (proceeds from left to right). 
b. Unary minus. 
c. Multiplication and Division (of equal priority). 
d. Addition and Subtraction (of equal priority). 
e. Logical operators in the order NOT, AND, then OR. 
3. If either 1 or 2 above does not clearly designate the order of 
priority, then the evaluation of expressions proceeds from 


left to right. 


The expression AABAC is evaluated from left to right as follows: 


1. AAB step l 


2. (result of step 1)AC 


answer 


The expression A/B*C is also evaluated from left to right since multi- 
plication and division are of equal priority: 


1. 


ted 
“\ 
w 

I 


step l 
2. (result of step 1)*C = answer 


The expression A+B*CAD is evaluated as: 


1. CAD = step l 
2. (result of step 1)*B = step 2 
3. (result of step 2)+A = answer 


Parentheses may be nested, or enclosed by a second set (or more) of 
parentheses. In this case, the expression within the innermost paren- 
theses is evaluated first, and then the next innermost, and so on, until 
all have been evaluated. 

In the following example: 


A=7* ( (BA2+4) /X) 


The order of priority is: 
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it DBAZ = step 1 
2. (result of step 1)+4 = step 2 
3. (result of step 2)/X = step 3 
4. (result of step 3)*7 =A 


Parentheses also prevent any confusion or doubt as to how the expression 


is evaluated. For 


example: 


A*BA2/74+B/C*DA2 
( (A*BA2) /7+ ( (B/C) *DA2) 


Both of these formulas are executed in the same way, but the second is 
easier to understand. 


Spaces may be used 


in a similar manner. Since the BASIC 8001 interpreter 


ignores spaces (except when enclosed in quotation marks), the two 


statements: 


19 LET B = DA2 + 1 


1QLETB=DA2+1 


are identical, but 
When the statement 


spaces in the first statement provide ease in reading. 
is subsequently printed, extra spaces are ignored. 


Vil. RELATIONAL OPERATORS 


Relational operators allow comparison of two values and are used to 


compare arithmetic 


expressions or strings in an IF. . . THEN statement. 


The relational operators are: 


Mathematical BASIC 8001 
Symbol Symbol Example Meaning 

= = A=B A is equal to B. 

ss < aA<B A is less than B. 

S$ <= or =“ AG B A is less than or 
equal to B. 

me > ADB A is greater than B. 

2 >= or =? E, A= B A is greater than 
or equal to B. 

# <>? or DS ACB A is not equal to B. 


The symbols =< =) 


,2% are accepted by BASIC 8001 but are converted to 
are shown in that form in a listing. 
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BASIC 8001 STRINGS 


CLEAR X RESERVES X BYTES FOR STRING DATA 
qT. STRINGS 


The previous section described the manipulation of numerical information 
only; however, BASIC 8001 also processes information in the form of 
character strings. A string, in this context, is a sequence of characters 
treated as a unit. A string can be composed of alphabetic, numeric, or al- 
phanumeric characters. (An alphanumeric string is one which contains 
letters, numbers, spaces or any combination of characters.) A character 
string can be 255 characters long. Strings cannot be typed on more than 
one terminal line since a carriage return terminates the command. 


Ts STRING VARIABLES 


Any variable name followed by a dollar sign ($) character indicates a 
string variable. For example: 


AS 
C7$ 


are simple string variables and can be used, for example, as follows: 


LET A$="HELLO" 
PRINT AS 


Note that the string variable A$ is separate and distinct from the variable 
A. 


In BASIC 8001, all control characters above control code F (or 6) are legal 
within Quotes (") except for the following: 


Control Code K or 11 or erase line 
Control Code L or 12 or erase page 
Control Code M or 13 or return 
Control Code Z or 26 or cursor left 


ETT. SUBSCRIPTED STRING VARIABLES 


Any list of matrix variable name followed by the $ character denotes the 
string form of that variable. For example: 


VS (n) M2$ (n) 
C$ (m,n) G1S$ (m,n) 


where m and n indicate the position of the matrix element within the 
whole. 


The same name can be used as a numeric variable and as a string variable 


in the same program with no restriction. A one- and a two-dimensional 
matrix can have the same name in the same program. For example: 
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A A(n) A(m,n) 
AS AS (m,n) AS (m,n ( 


can all be used in the same program. 


String lists and matrices are defined with the DIM statement as are 
numerical lists and matrices. 


IV. STRING OPERATIONS 
Concatenation 


Concatenation puts one string after another without any intervening 
characters. It is specified by a plus sign (+) and works only with 
strings. The maximum length of a concantenated string is 255 char- 
acters. 


For example: 


1f READ AS, BS, C$ 

AG. DATA. Mail. "33". 822" 
38 LET DS = AS+C$+B$ 

35 PRINT DS 

4% END 

RUN 

112233 


Vie RELATIONAL OPERATIONS 


When applied to string operands, the relational operators indicate 
alphabetic sequence. The comparison is done on the basis of the ASCII 
value associated with each character in the strings being compared. For 
example: 


55 IF AS€BS$ THEN 100 


When line 55 is executed, the first characters of each string (AS and 
BS) are compared, then the second characters of each string and so on 
until the character in A$ is less than the character in B$. Then 
execution continues at line 100. Essentially, the strings are compared 
for alphabetic order. The next page contains a list of the relational 
operators and their string interpretations. 


In any string comparison, trailing blanks are ignored (i.e., "ABC" is 
equivalent to "ABC "). 


FRE (x) =AVAILABLE BYTES OF PROGRAM MEMORI. 
FRE(K$)2AVAILABLE BATES OF STRING MEMORY. 


TotAl AVAILABLE MEMOoRS 1S Eee (x) + FRE(X$)...can adjust € transfer by CLEAR X. 
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BASIC 8001 


Relational Operators Used With 
String Variables 


Example Meaning 


Operator 
< 
? 
fa or = € 
>= or => 
<> or 2S 


AS = BS The strings A$ and BS are al- 
phabetically equal. 


as < Bs The string A$ alphabetically 
precedes BS. 

AS > BS The string A$ alphabetically 
follows BS. 

AS = BS The string A$ is equivalent to 
or precedes BS in alphabetical 
sequence. 

AS>= BS The string A$ is equivalent to 
or follows B$ in alphabetical 
sequence. 

aS <> Bs The strings A$ and B$ are not 


alphabetically equal. 
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BASIC 8001 IMMEDIATE MODE 


I. USE OF IMMEDIATE MODE FOR STATEMENT EXECUTION 


It is not necessary to write a complete program to use BASIC 8001. 
Most of the statements discussed in this manual can be included in a 
program for later execution or given on-line as commands, which are 
immediately executed by the 8080 CPU. This latter facility makes 
BASIC 8001 an extremely powerful calculator. 


BASIC 8001 distinguishes between lines entered for later execution 
and those entered for immediate execution solely by the presence (or 
absence) of a line number. Statements which begin with line numbers 
are stored; statements without line numbers are executed immediately 
upon being entered to the system. Thus the Line: 


19 PRINT "THIS IS A COMPUCOLOR 8001" 
produces no action at the console upon entry, while the statement: 

PRINT "THIS IS A COMPUCOLOR 8001" 
causes the immediate output: 

THIS IS A COMPUCOLOR 8001 
II. PROGRAM DEBUGGING 
Immediate mode operation is especially useful in two areas: program 
debugging and the performance of simple calculations in situations which 
do not occur with sufficient frequency or with sufficient complications 
to justify writing a program. 
In order to facilitate debugging a program, STOP statements can be 
liberally placed throughout the program. Each STOP statement causes 
the program to halt, at which time the various data values can be 
examined and perhaps changed in immediate mode. The 

GO TO xxxxx 
command is used to continue program execution (where xxxxx is the number 
of the next program line to be executed). GOSUB and IF commands could 
also be used. The values assigned to variables when the RUN command was 
executed remain intact until a NEW, CLEAR or another RUN command is 


executed. 


If the STOP occurs in the middle of a FOR loop, modifications cannot be 
made to the section of the program preceding the FOR. 
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When using immediate mode, nearly all the standard statements can be 
used to generate or print results. 


If CTRL/J or linefeed is used to halt program execution, the GO TO XXXX or CONT 
command can be used to continue execution, since CTRL J or linefeed 

does print the number of the line where execution stopped. It is 

easy to know where to resume the program. 


III. MULTIPLE STATEMENTS PER LINE 


Multiple statements can be used on a single line in immediate mode. 
For example: 


A=1:PRINT A 
1 


Program loops are allowed in immediate mode; thus a table of square 
roots can be produced as follows: 


FOR I=l TO 19: PRINT I, SOR (I) :NEXT I 


uu i 

2 1.41421 
3 1.73205 
4 2 

5 2.23697 
6 2.44949 
7 2.64575 
8 2.82843 
i] 3 

19 3.16228 
READY 


IV. RESTRICTIONS ON IMMEDIATE MODE 


The INPUT statement cannot be used in immediate mode and such use results 
in the following error message: 


ID ERROR 
READY 


Certain commands, while not illegal, make no logical sense when used in 
immediate mode. Commands in this category are DEF, DIM and DATA. 


Also since user functions are not defined until the program is executed, 
function references in immediate mode cause an error unless the program 
containing the definition was previously executed. 


Thus, the following dialogue might result if a function was defined in 
a user program and then referenced in immediate mode. 


1 DEF FNA(X) = XA2 + 2*X:REM SAVED STATEMENT 
PRINT FNA(1):REM IMMEDIATE MODE 


UF ERROR 
READY 22 


but if the sequence of statements is: 


10 DEF FNA(X) = XA2+2*X:REM SAVED STATEMENT 
RUN 


READY 


PRINT FNA(1) 
3 


READY 


the immediate mode statement is executed. 
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BASIC 8001 STATEMENTS 


A user program is composed of lines of statements containing instructions 

to BASIC 8001. Each line of the program begins with a line number that identi- 
fies that line as a statement and indicates the order of statement execution. 
Each statement starts with an English word specifying the type of operation 

to be performed. The statement lines are terminated with the RETURN key 

which is non-printing. 


I. STATEMENT NUMBERS 


An integer number is placed at the beginning of each line in a BASIC 8001 
program. BASIC 8001 executes the statements in a program in numerically 
consecutive order regardless of the order in which they were typed. 
Statement numbers must be within the range O to 65529. When first writing 
a program, it is advisable to number lines in increments of five or ten to 
allow insertion of forgotten or additional lines when debugging the program. 


All BASIC 8001 statements and computations must be written on a single line; 
they cannot be continued onto a following line. However, more than one 
statement may be written on a single line when each statement after the 
first is preceded by a colon (:). For example: 


18 INPUT A,B,C 
is a single statement line, whereas 
29 LET X=11: PRINT X,Y,Z: IF X=A THEN 19 


is a multiple statement line containing three statements: LET, PRINT, and 
IF. Most statements may be used anywhere in a multiple statement line;, 
exceptions are noted in the discussion of each statement. Only the first 
statement on a line can (and must) have a line number.; It should be re- 
membered that program control cannot be transferred to’a statement within a 
line, but only to the first statement of a line. 


II. REMARK STATEMENT 


It is often desirable to insert notes and messages within a user program. 
Such data as the name and purpose of the program, how to use it, how 
certain parts of the program work, and expected results at various points 
are useful things to have present in the program for ready reference by 
anyone using that program. 


The REMARK or REM statement is used to insert remarks or comments into a 
program without these comments affecting execution. Remarks do, however, 


use core area which may be needed by an exceptionally long program. 


The REMARK statement must be preceded by a line number and may be used 
anywhere in a multiple statement line. The message itself can contain 
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any printing character on the keyboard. BASIC 8001 completely ignores 
anything on a line following the letters REM. (The line number of a REM 
statement can be used in a GOTO or GOSUB statement, see sections pertaining 
to destination of a jump in the program execution.) Typical REM statements 
are shown below: 


10 REM- THIS PROGRAM COMPUTES THE 
11 REM- ROOTS OF A QUADRATIC EQUATION 


III. THE ASSIGNMENT STATEMENT - LET 


The LET statement assigns a value to the specified variable(s). The 
general format of the LET statement is: 


LET variable = expression 


where variable is a numeric or string variable and expression is an 
arithmetic or string expression. All items in the statement must be 
either string .or numeric; they cannot be mixed. The word LET is optional. 


The LET statement does not indicate algebraic equality, but performs 
calculations within the expression (if any) and assigns the value to the 
variable. 


The meaning of the equal (=) sign should be clarified. In algebraic 
notation, the formula X=X+l is meaningless. However, in BASIC 8001 (and 
most computer languages), the equal sign designates replacement rather 


than equality. Thus, this formula is actually translated: "add one to 
the current value of X and store the new result back in the same variable 
X". Whatever value has previously been assigned to X will be combined 


with the value 1. An expression such as A=B+C instructs the computer to 
add the values of B and C and store the result in a third variable A. The 
variable A is not being evaluated in terms of any previously assigned value, 
but only in terms of B and C. Therefore, if A has been assigned any value 
prior to its use in this statement, the old value is lost; it is instead 
replaced by the value B+C. 
a LI 7) 

Example: X=2Y4=2=Q% is net evaluated fer X298, 3248, 2=46... rater, Tis 

evaluated logically where we fest tf Y227°9F and assign result +X, 


LET X=2 Assigns the value 2 to the variable X. 

LET X=X+1+Y Adds 1 to the current value of X then adds the 
value of Y to the result and assigns that value 
to X. 


IV. THE DIMENSION STATEMENT - DIM 


The DIMension statement is used to define the maximum number of elements 
in a matrix. The DIM statement is of the form: 


DIM variable(n), variable(n,m), variableS(n), variableS$ (n,m) 


where variables specified are indicated with their maximum subscript value(s). 
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For example: 


1g DIM X(5), ¥(4,2), A(1g ,19) 
12 DIM A4(1@9), A$(25) 


Only integer constants (such as 5 or 5070) can be used in DIM statements 
to define the size of a matrix. Variables cannot be used to specify the 
bounds of arrays. Any number of matrices can be defined in a single DIM 
statement as long as their representations are separated by commas. 


The first element of every matrix is automatically assumed to have a “ub- 
script of zero. Dimensioning A(6,10) sets up room for a matrix with 7 
rows and 11 columns. This zero element is illustrated in the following 
program: 


1g REM - MATRIX CHECK PROGRAM 
2M DIM A(6,19) 

39 FOR I= TO 6 

4g LET A(I,@) =I 

5% FOR J=9 TO 19 

69 LET A(G,J) = J 

7% PRINT A(I,J); 

8% NEXT J:PRINT:NEXT I 

99 END 


AnPWNE DR 
BQRQRQRQRQQH 
BQVRQRQQRQQN 
QRQQQRQ]NR W 
RQRORQQQDEA 
VQQQRQRQQU 
BQRQRQQRQ!N O 
BQO QQQR~ 
RQ QQQRQRO 
RQQRQRRR YL 
BQRQRQQQRQEKE 


READY 


Notice that a variable has a value of zero until it is assigned another 
value. 


Whenever an array is dimensioned (n,m), the matrix is allocated m+l, n+l 
elements. Core space can be conserved by using the Oth element of the 
matrix. For example, DIM A(5,9) dimensions a 6 x 10 matrix which would 
then be referenced beginning with the A(0,0) element. 


The size and number of matrices which can be defined depend upon the 
amount of storage space available. 


A DIM statement can be placed anywhere in a multiple statement line and 
can appear anywhere in the program. A matrix can only be dimensioned 
once. DIM statements need not appear prior to the first reference to an 
array, although DIM statements are generally among the first statements 

of a program to allow them to be easily found if any alterations are later 
required. 
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All arrays specified in DIM statements are allocated space when the RUN 
command is executed. 


V. PLOT STATEMENT 


The PLOT Statement is used to output the 8 bit BYTE value of an expression 
to the CRT Screen. The general format of the PLOT Statement is: 


10 PLOT expression 


The expression can be any combination of variables which will evaluate 
to a positive value between O and 255. 


The following example will plot a point on the CRT Screen at Location 
80;,-96 (X,Y) 


10 X=80 : Y=96 

20 PLOT 2 : REMARK THE 8001 PLOT MODE CODE 

30 PLOT X : PLOT Y : REMARK PLOTS POINT AT 80, 96 

40 PLOT 255 : REMARKS THE 8001 PLOT MODE ESCAPE CODE 


As another example enter: a “PLOT 7! 
° pLot 65: PLOTeb: PLOT67: PLOTGS: PLOT 6% : PLOT 70 Ph 
PLOT 65 ABLDLEG 
A 


READY READY, BASIC DOES Nor (FER) BETWEEN PLOTS. 


It can be seen that (since 65 is the decimal ASCII value for A) PLOT 65 
is the same as PRINT cays 


VI. PRINT STATEMENT 


The PRINT statement is used to output data to the terminal. The general 
format of the PRINT statement is: 


1) PRINT list 
The list is optional and can contain expressions, text strings, or both. 
When used without the list, the PRINT statement: 

25 PRINT 


pots NOT ERASE, TUST SKIPS Down. 


causes a blank line to be output on the 8001 CRT Screen (a carriage return/ 
line feed operation is performed) . 


2) PRINT Expression 
PRINT statements can be used to perform calculations and print results. 


Any expression within the list is evaluated before a value is printed. 
For example: 
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19 LET A=l : LET B=2: LET C=3+A 
29 PRINT 

3% PRINT A+B+C 

RUN 


7 
READY 
All numbers are printed with a preceding and following blank space. 


The PRINT statement can be used anywhere in a multiple statement line. 
For example: 


19 A=1: PRINT A: A=A+5: PRINT: PRINT A 
prints the following on the terminal when executed: 

al 

6 

READY 
Notice that the terminal performs a carriage return/line feed at the end 
of each PRINT statement. Thus the first PRINT statement outputs a 1 and 
a carriage return/line feed; the second PRINT statement the blank line; 
and the third PRINT statement, a 6 and another carriage return/line feed. 

3) PRINT Strings 
The PRINT statement can be used to print a message or string of characters, 
either alone or together with the evaluation and printing of numeric values. 
Characters are indicated for printing by enclosing them in double quotation 
marks. For example: 

18 PRINT "TIME'S UP" 

28 PRINT "NEVERMORE" 

RUN 

TIME'S UP 

NEVERMORE 

READY 
As another example, consider the following line: 

49 PRINT "AVERAGE GRADE IS";X 


which prints the following (where X is equal to 83.4): 


AVERAGE GRADE IS 83.4 
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When a character string is printed, only the characters between the 
quotes appear; no leading or trailing spaces are added. Leading and 
trailing spaces can be added within the quotation marks using the key- 
board space bar; spaces appear in the printout exactly as they are typed 
within the quotation marks. 


When a comma separates a text string from another PRINT list item, the 
item is printed at the beginning of the next available print zone. 
Semicolons separating text strings from other items are ignored. Thus, 
the previous example could be expressed as: 


4% PRINT "AVERAGE GRADE IS" X 
and the same printout would result. A comma or semicolon appearing as 
the last item of a PRINT list always suppresses the carriage return/line 


feed operation. 


BASIC 8001 does an automatic carriage return/line feed if a string is 
printing past column 80. 


4) Use of "," and "3" 
BASIC 8001 considers the 8001 CRT Screen to be divided into ten zones of 
eight spaces each. When an item in a PRINT statement is followed by a 


comma, the next value to be printed appears in the next available print 
zone. For example: 


19 LET A=3: LET B=2 
29 PRINT A,B,A+B,A*B,A-B,B-A 


When the preceding lines are executed, the following is printed: 
3 2 5 6 1 -1 
Notice each character is 8 spaces from the next character. 


Two commas together in a PRINT statement cause a print zone to be skipped. 
For example: 


1@ LET A=1/ LET B=2 

2G PRINT A,B,,A+B 

RUN 

1 2 3 


READY 
If the last item in a PRINT statement is followed by a comma, no carriage 


return/line feed is output, and the next value to be printed (by a later 
PRINT statement) appears in the next available print zone. For example: 
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19 A=1:B=2:C=3 

28 PRINT A, :PRINT B: PRINT C 
RUN 

1 2 

3 


READY 


If a tighter packing of printed values is desired, the semicolon 
character can be used in place of the comma. A semicolon causes no 
further spaces to be output other than the leading and trailing space 
automatically output with each number. A comma causes the print head 
to move at least one space to the next print zone or possibly perform 
a carriage return/line feed. The following example shows the effects 
of the semicolon and comma. 


19 LET A=1/ B=2/ C=3 
208 PRINT A;B;C; 
38 PRINT A+1;B+1;C+l 


4% PRINT A,B,C 
RUN 


READY 


The following example demonstrates the use of the formatting characters , 
and ; with text strings: 


128 PRINT "STUDENT NUMBER"X, "GRADE ="G;"AVE. ="A; 
138 PRINT "NO. IN CLASS ="N 


could cause the following to be printed (assuming calculations were done 
prior to line 130): 


STUDENT NUMBER 119959 GRADE = 87 AVE. = 85.44 NO. IN CLASS = 26 

5) PRINT Statement - TAB Function 
The TAB function is used in a PRINT statement to write spaces to the spec- 
ified column on the output device. The columns on the output devices are 
numbered 1 to 80. 


The form of the command is: 


PRINT TAB (x) 


where (x) is the column number in the range 0-255. (If X exceeds 80, 
however, every other consecutive line is tabbed until the number of 
spaces to be output is less than or equal to 80). If the column number 


specified is greater than 255 or negative, an error message is printed 
as follows: 


CF ERROR 
READY 
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If (x) is non-integer, only the integer portion of the number is 
used. 


If the column number (x) specified is less than or equal to the 
current column number, the TAB function has no effect. 


VII. INPUT STATEMENT 


The INPUT statement is used when data is to be input from the terminal 
keyboard during program execution. The form of the statement is: 


1) INPUT list 
where list is a list of variable names separated by commas. 
For example: 

19 INPUT A,B,C 


causes the computer to pause during execution, print a question mark, 
and wait for input of three numeric values separated by commas. The 
values are input to the computer by typing the RETURN key. 


If too few values are entered, BASIC 8001 prints another ? to indicate 
that more data is needed. If too many values are typed, the excess 

data on that line is ignored and the message below is printed but program 
still continues. The values entered in response to the INPUT statement 
cannot be continued on another line and are terminated by the RETURN 

key. Values must be separated by commas, if more than one value is 

input on the same line. 


When there are several values to be entered via the INPUT statement, 
it is helpful to print a message explaining the data needed. For 


example: 


19 PRINT "YOUR AGE IS"; 
2¢ INPUT A 


2) INPUT “string”; 2ist 


The INPUT statement can also contain quoted strings. The above example 
could be written: 


10 INPUT "YOUR AGE IS?";A 
Note that when a quoted string is included in a INPUT statement, the 
normal ? is not printed as a prompt character, and if desired, must 


be included as shown within the quotes above. 


This feature allows BASIC 8001 to be programmed to handle fill-in-the- 
forms type of applications. 


31. 


VIII. DATA STATEMENT 


The DATA statement is used in conjunction with the READ statement to 
enter data into an executing program. One statement is never used 
without the other. The form of the statement is: 


DATA value list 


where the value list contains the numbers or strings to be assigned to 
the variables listed in a READ statement. Individual items in the value 
list are separated by commas; strings must be enclosed in quotation 
marks. 


For example: 


15f DATA 4,7.2,3,"26C" 
179 DATA 1,34E-3, 3.17311 


The location of DATA statements is arbitrary as long as they appear in 
the correct order; however, it is good practice to collect all DATA 
statements near the end of the program. 


When the RUN command is executed, BASIC 8001 searches for the first DATA 
statement and saves a pointer to its location. Each time a READ statement 
is encountered in the program, the next value in the data statement is 
assigned to the designated variable. If there are no more values in that 
DATA statement, BASIC 8001 looks for the next DATA statement. 


IX. READ STATEMENT 


A READ statement is used to assign the values listed in a DATA statement 
to the specified variables. The READ statement is of the form: 


READ variable list 


The items in the variable list may be simple variable names or string 
variable names and are separated by commas. For example: 


19 READ A, BS, C(1) 
20 DATA 12, "12",.12E2 


Since data must be read before it can be used in a program, READ statements 
generally occur near the beginning of the program. A READ statement can be 
placed anywhere in a multiple statement line. 


If there is no data available in the data table for the READ to store, the 
out of data message below is printed: 


OD. ERROR IN xxxxx 
READY 


Items in the data list in excess of those needed by the program's READ 
statements are ignored. 
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X. RESTORE STATEMENT 


The RESTORE statement causes the program to reuse the data from the 
first DATA statement and is of the form: 


RESTORE 
For example: 
38 RESTORE 


causes the next READ statement following line 30 to begin reading data 
from the first DATA statement in the program, regardless of where the 
last value was found. 


A further example of the use of RESTORE follows: 


15 READ B,C,D 


55 RESTORE 
6% READ E,F,G 


88 DATA 6,3,4,7,9,2 


199 END 


The READ statements in lines 15 and 60 both read the first three data 
values provided in line 80. (If the RESTORE statement had not been 
inserted before line 60, then the second READ would pick up data in 
line 80 starting with the fourth value.) 


Since the values are being read as though for the first time, the same 
variable names may be used the second time through the data, if desired. 
To skip unwanted values, replacement, or dummy, variables may be inserted. 
For example: 


1 REM - PROGRAM TO ILLUSTRATE USE OF RESTORE 
29 READ N 

25 PRINT "VALUES OF X ARE:" 

38 FOR I=l TON 

49 READ xX 

5 PRINT xX, 

6% NEXT I 

78 RESTORE 

185 PRINT 

198 PRINT "SECOND LIST OF X VALUES" 

200 PRINT "FOLLOWING RESTORE STATEMENT: " 
219 FOR I=l TON 

22 READ X 

230 PRINT xX, 


249 NEXT I 33 


25M DATA 4,1,2 
251 DATA 3,4 
308 END 


RUN 
VALUES OF X ARE: 

1 2 3 4 
SECOND LIST OF X VALUES 
FOLLOWING RESTORE STATEMENT: 

4 L 2 3 
READY 


The second time the data values are read, the first X picks up the 
value originally assigned to N in line 20, and as a result, BASIC 
prints: 


4 ul 2 3 


To circumvent this, a dummy variable could be inserted to pick up and 
store the first value. This variable would not be represented in the 
PRINT statement, so the output would be the same each time through 
the list. 


XI. GOTO STATEMENT 


The GOTO statement is used when it is desired to unconditionally transfer 
to some line other than the next sequential line in the program. In 
other words, a GOTO statement causes an immediate jump to a specified 
line, out of the normal consecutive line number order of execution. The 
general format of the statement is as follows: 


GOTO line number 


The line number to which the program jumps can be either greater or less 
than the current line number. It is thus possible to jump forward or 
backward within a program. 


For example, 


19 LET A=2 

28 GOTO 5¢ 

30 LET A=SOR(A+14) 
50 PRINT A,A*A 
RUN 


causes the following to be printed: 

2 4 
When the program encounters line 20, control transfers to line 50; line 
50 is executed, control then continues to the line following line 50. 


Line 30 is never executed. Any number of lines can be skipped in either 
direction. 
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When written as part of a multiple statement line, GOTO should always 
be the last statement on the line, since any statement following the 
GOTO on the same line is never executed. For example: 


11% LET A=ATN(B2):PRINT A:GOTO 59 
XII. IF-THEN, IF-GOTO STATEMENTS 


The IF-THEN statement is used to transfer conditionally from the normal 
consecutive order of statement numbers, depending upon the truth of some 
mathematical relation or relations. The basic format of the IF statement 
is as follows: 
THEN 
IF expression rel.op. expression line number 
GOTO 


where expression is an arithmetic or string expression. 


Expressions cannot be mixed; both must be string 

or both must be numeric. Numeric comparisons are 
handled as described in the ARITHMETIC Section. String 
comparisons are performed on the ASCII values of 

the strings as described in the STRING Section. 


rel."Ops is one of the operators described in the ARITHMETIC 
Section. 
line number is the line of the program to which control is 


conditionally passed. 


If the value of the expression is true, control passes to the line number 
specified. 


If the value of the expression is false, control passes to the next state- 
ment in sequence. 


Examples: 
19 IF A=B THEN 2%:PRINT "A B" 
15 STOP 
28 PRINT A+B 
19 IF A<>1G GOTO 29 :PRINT A 
15 STOP 
28 D=A+B*C 


1% IF AS€BS THEN 2%:STOP 
2% PRINT AS 


XIII. FOR-NEXT STATEMENTS 


FOR and NEXT statements define the beginning and end of a loop. (A loop 
is a set of instructions which are repeated over and over again, each time 
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being modified in some way until a terminal condition is reached.) 
The FOR statement is of the form: 


FOR variable expressionl TO expression2 STEP expression3 


where 
variable must be a nonsubscripted numeric variable. 


expression is an arithmetic expression which may be non- 
integer. 


The variable is the index; expressionl is the initial value; expression2, 
the terminal value and expression3, the increment value. 


For example: 
15 FOR K=2 TO 28 STEP 2 


causes the program execution of the designated loop as long as K is 
less than or equal to 20. Each time through the loop, K is incremented 
by 2, so the loop is executed a total of 10 times. When K=20, program 
control passes to the line following the associated NEXT statement. 


The index variable must be unsubscripted, although a common use of such 
loops is to deal with subscripted variables using the control variable 
as the subscript of a previously defined variable. The expressions in 
the FOR statement can be any acceptable BASIC 8001 expression. 


The NEXT statement signals the end of the loop which began with the 
FOR statement. The NEXT statement is of the form: 


NEXT variable 


where the variable is the same variable specified in the FOR statement. 
Together the FOR and NEXT statements define the boundaries of the 
program loop. When execution encounters the NEXT statement, the computer 
adds the STEP expression value to the variable and checks to see if the 
variable is still less than or equal to the terminal expression value. 
When the variable exceeds the terminal expression value, control falls 
through the loop to the statement following the NEXT statement. Note 

the variable is not necessary since when a NEXT statement is encountered 
it is assumed it is for the appropriate FOR loop variable. 


If the STEP expression and the word STEP are omitted from the FOR state- 
ment, +l is the assumed value. Since +l is a common STEP value, that 
portion of the statement is frequently omitted. 


The expressions within the FOR statement are evaluated once upon initial 
entry to the loop. The test for completion of the loop is made after 
each execution of the loop. (If the test fails initially, the loop is 
still executed once.) 
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The index variable can be modified within the loop. When control falls 
through the loop, the index variable retains the value used to fall through 
the loop. 


The following is a demonstration of a simple FOR-NEXT loop. The loop 
is executed 10 times; the value of I is 11 when control leaves the loop; 
and +l is the assumed STEP value: 


1% FOR I=1 TO 19 
28 PRINT I 

30 NEXT I 

4Q PRINT I 


The loop itself is lines 10 through 30. The numbers 1 through 10 are 
printed when the loop is executed. After I=10, control passes to line 
40 which causes 11 to be printed. If line 10 had been: 

19 FOR I = 19 TO 1 STEP -1 
the value printed by line 40 would be @. 

19 FOR I = 2 TO 44 STEP 2 


2 LET I = 44 
30 NEXT I 


The above loop is only executed once since the value of I=44 has been 
reached and the termination condition is satisfied. 


If the initial value of the variable is greater than the terminal value, 
the loop is still executed once. The loop set up by the statement: 


1 FOR I = 2% TO 2 STEP 2 


will be executed only once although a statement like the following will 
initialize execution of a loop properly: 


18 FOR I=28 TO 2 STEP -2 


For positive STEP values the loop is executed until the control variable 
is greater than its final value. For negative STEP values, the loop 
continues until the control variable is less than its final value. 


FOR loops can be nested but not overlapped. The depth of nesting depends 
upon the amount of user storage space available (in other words, upon the 
size of the user program and the amount of RAM available). Nesting is a 
programming technique in which one or more loops are completely within 
another loop. The field of one loop (the numbered lines from the FOR 
statement to the corresponding NEXT statement, inclusive) must not cross 
the field of another loop. 


OF; 


ACCEPTABLE NESTING UNACCEPTABLE NESTING 
TECHNIQUES TECHNIQUES 


Two Level Nesting 


FOR Il = 1 TO 10 FOR Tl = £ TO: 10 
eae I2 = 1 TO 10 FOR I2 = 1 TO 10 
NEXT I2 NEXT Il 
FOR 23. = 1. TOn10 NEXT I2 
NEXT I3 
NEXT I1 
Three Level Nesting 
FOR Il = 1 TO 10 FOR Il = 1 TO 10 
FOR I2 = 1 TO 10 FOR, 12. =°1 To 10 
oe 13. = 1 TO: .10 FOR I3 = 1 TO 10 
NEXT 13 NEXT I3 
eee 14 = 1] To 10 [peas I4 = 1 T0 10 
NEXT 14 NEXT 14 
NEXT 12 NEXT I1 
NEXT I1 NEXT 12 


An example of nested FOR-NEXT loops is shown below: 


5 DIM X(5,18) 

19 FOR A=l1 TO 5 

28 FOR B=2 TO 19 STEP 2 
39 LET X(A,B)= A+B 

4g NEXT B 

50 NEXT A 

55 PRINT xX(5,1Q) 


When the above statements are executed, BASIC 8001 prints 15 when line 
55 is processed. 


It is possible to exit from a FOR-NEXT loop without the control variable 

reaching the termination value. A conditional or unconditional transfer 

can be used to leave a loop. Control can only transfer into a loop which 
had been left earlier without being completed, ensuring that termination 

and STEP values are assigned. 


Both FOR and NEXT statements can appear anywhere in a multiple statement 
line. For example: 


19 FOR I=1 TO 19 STEP 5:NEXT I: PRINT "I=";1 
causes: 
I=1l 


to be printed when executed. 
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XIV. GOSUB AND RETURN STATEMENTS 


A subroutine is a section of code performing some operation required 
at more than one point in the program. Sometimes a complicated I/O 
operation for a volume of data, a mathematical evaluation which is too 
complex for a user-defined function, or any number of other processes 
may be best performed in a subroutine. 


More than one subroutine can be used in a single program, in which 
case they can be placed one after another at the end of the program 
(in line number sequence). A useful practice is to assign distinc- 
tive line numbers to subroutines; for example, if the main program 
uses line numbers up to 199, use 200 and 300 as the first numbers of 
two subroutines. 


Subroutines are usually placed physically at the end of a program 
before DATA statements, if any- The program begins execution and 
continues until it encounters a GOSUB statement of the form: 


1) GOSUB line number 


where the line number following the word GOSUB is that of the first 
line of the subroutine. Control then transfers to that line of the 
subroutine. For example: 


5% GOSUB 299 


Control is transferred to line 200 in the user program. The first 
line in the subroutine can be a remark or any executable statement. 


Having reached the line containing a GOSUB statement, control trans- 
fers to the line indicated after GOSUB; the subroutine is processed 
until BASIC 8001 encounters a RETURN statement of the form: 


2) RETURN 


which causes control to return to the statement following the original 
GOSUB statement. A subroutine must always be exited via a RETURN 
statement. 


Before transferring to the subroutine, BASIC 8001 internally records the 
next sequential statement to be processed after the GOSUB statement; 

the RETURN statement is a signal to transfer control to this statement. 

In this way, no matter how many subroutines there are or how many times 

they are called, BASIC 8001 always knows where to transfer control next. 
The following program demonstrates the use of GOSUB and RETURN. 


il REM - THIS PROGRAM ILLUSTRATES GOSUB AND RETURN 
1g DEF FNA(X)= ABS (INT (X) ) 
2g INPUT A,B,C 


3B GOSUB 199 
4g LET A=FNA (A) 
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59 LET B=FNA(B) 

6B LET C=FNA(C) 

70 PRINT 

8G GOSUB 199 

9B STOP 

189 REM - THIS SUBROUTINE PRINTS OUT THE SOLUTIONS 
118 REM - OF THE EQUATION: AXa2 + BX + C = @Q@ 

128 PRINT "THE EQUATION IS "A "*XA2 + " BU*X + "C 
139 LET D=B*B -— 4*A*C 

149 IF D€>0 THEN 1792 

158 PRINT "ONLY ONE SOLUTION... X "; -B/(2¥*A) 

169 RETURN 

17¢ IF D€M THEN 22¢ 

188 PRINT "TWO SOLUTIONS...X ="; 

185 PRINT (-B+SQR(D))/(2*A); ") AND ("; (-B-SQR(D))/(2*A) 
199 RETURN 

298 PRINT "IMAGINARY SOLUTIONS ...X=("; 


285 PRINT -B/(2*A) "," SOR(-D)/(2*A) ") AND ("; 
287 PRINT -B/(2*A) ","; -SOR(-D)/(2*A) ")" 

218 RETURN 

998 END 


Subroutines can be nested; that is, one subroutine can call another 
subroutine. If the execution of a subroutine encounters a RETURN 
statement, it returns control to the line following the GOSUB which 
called that subroutine. Therefore, a subroutine can call another 
subroutine, even itself. Subroutines can be entered at any point 

and can have more than one RETURN statement. It is possible to trans- 
fer to the beginning or any part of a subroutine; multiple entry points 
and RETURN's make a subroutine more versatile. Up to 20 levels of 
GOSUB nesting are allowed. 


XV. END STATEMENT 


~The END statement is the last statement in a BASIC program and is of 
the form: 


END 
The line number of the END statement must be the largest line number 
in a given program, since any lines having line numbers greater than 
that of the END statement are not executed (although they are saved 
with the SAVE command) . 


The END statement is optional. When an END statement is executed, 
program execution stops and the READY message is printed. 


XVI. STOP STATEMENT 
The STOP statement can occur several times throughout a single program 
with conditional jumps determining the actual end of the program. The 


STOP statement is of the form: 


90 STOP 
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and causes: 


BREAK IN 90 
READY 


to be printed when executed. 


This signals that the execution of a program has been terminated and 
BASIC 8001 is able to accept further input. 


41 


BASIC 8001 FUNCTIONS 


ARITHMETIC FUNCTIONS 


BASIC 8001 provides functions to perform certain standard mathematical 
operations such as square roots, logarithms, etc. 


These functions have three or four letter call names followed by 
a parenthesized argument. They are pre-defined and may be used 
anywhere in a program. 


Call Name Function 
ABS (x) Returns the absolute value of x. 
ATN (x) Returns the arctangent of x as an 


angle in radians in range + or -pi/2. 


CALL (x) CALL the user, machine 0g Zane set 

at location QA Hex, AQUV=SM¥ = -2457 
PEI? ADOIsLo =~-2eu575 
Ago2= Hi =-24574 

COS (x) Returns the cosine of x radians. 

EXP (x) Returns the value of e* where e=2.71828. 

FRE (x) Returns number of free BYTES not in use. 

INT (x) Returns the greatest integer less than 
or equal to x, (INT(-.5)=-1). 

INP (x) Returns a BYTE from input port 0<x€255. 

LOG (x) Returns the natural logarithm of x. 

PEEK (x) Returns a BYTE from memory address 0<x<32767 
or if x is negative the memory address is 
65536+x. 

POS (x) Returns a value of current cursor positions 


between O and 79. 


x) Not 70° GOOD... REQLATS avtec 


RND( Returns a random number between O and l. 
only 1995 numbers, 

SGN (x) Returns a value indicating the sign of x. 

SIN (x) Returns the sine of x radians. 

SPC (x) Causes x spaces to be generated. 

SOR (x) Returns the square root of x. 

TAB (x) Causes the 8001 CRT to space over to column 


number x. Valid in PRINT statement only. 


TAN (x) Returns the tangent of x radians. 
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The argument x to the functions can be a constant, a variable, an 
expression, or another function. A square bracket cannot be used as 
the enclosing character for the argument x, e.g. SIN Es is illegal. 


Function calls, consisting of the function name followed by a paren- 
thesized argument, can be used as expressions or as elements of 
expressions anywhere that expressions are legal. 


Values produced by the functions SIN(x), COS(x), ATN(x), SOR(x), EXP( 
and LOG(x) have six significant digits. 


T, Sine and Cosine Functions, SIN(x) and COS (x) 


The sine and cosine functions require an argument angle expressed in 
radian measure. If the angle is stated in degrees, conversion to 
radians may be done using the identity: 


gradians> = <degree * (pi/180) 


In the following example program, 3.14159 is used as a nominal value 
for pi. P is set equal to this value at line 20. At line 40 the 
above relationship is used (in the expression within the LET statemer 
to convert the input value into radians. 


19 REM - CONVERT ANGLE (X) TO RADIANS, AND 
11 REM - FIND SIN AND COS 
20 LET P = 3.14159 
25 PRINT "DEGREES", "RADIANS", "SINE", "COSINE" 
38 INPUT X 
49 LET Y = x*P/180 
6M PRINT X, Y, SIN(Y), COS(Y) 

78 GOTO 30 
RUN 
DEGREES RADIANS SINE COSINE 
22 

i) g i) 1 
21d: 

1g .174533 . 173648 . 984898 
220 

20 . 349966 . 34292 . 939693 
230 

39 . 523598 25 . 866926 
2368 

369 6.28318 -5.2431QE-96 1 

245 

45 . 785398 . 797196 . 787127 
298 

99 1.5798 a 1.12352E-96 
?RETURN 
READY 
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Baie Arctangent Function, ATN(x); Tangent Function, TAN(x) 


The arctangent function returns a value in radian measure, in the range 
+pi/2 to -pi/2 corresponding to the value of a tangent supplied as the 
argument (xX). 


In the following program, input is an angle in degrees. Degrees are 
then converted to radians at line 40. 


At line 70 the tangent value, Z, is supplied as argument to the ATN 
function to derive the value found in column 4 of the printout under 
the label ATN(X). Also in line 70 the radian value of the arctangent 
function is converted back to degrees and printed in the fifth column 
of the printout as a check against the input value shown in the first 
column. 


19 LET P= 3.14159 
28 PRINT "SUPPLY AN ANGLE IN DEGREES" 


25 PRINT "ANGLE", "ANGLE", "TAN(X)", "ATAN(X)", "ATAN(X)" 
26 PRINT "(DEGS)","(RADS)",,,"(DEGS) " 
38 INPUT X 
49 LET Y = X*P/189¢ 
5% LET Z = TAN(Y) 
7% PRINT X,Y,Z,ATN(Z) , ATN(Z) *180/P 
85 PRINT 
98 GOTO 39 
RUN 
SUPPLY AN ANGLE IN DEGREES 
ANGLE ANGLE TAN (X) ATAN (X) ATAN (X) 
(DEGS) (RADS) (DEGS ) 
2B 
Bg B a Bg 
245 
45 . 785398 - 999999 - 785398 45 
?1¢ 
10 174533 . 176327 -174533 1g 
? (RETURN) 
READY 
Tid. Square Root Function, SQR(x) 


This function derives the square root of any positive value as shown 
below. 


1g INPUT xX 

20 LET X = SOR(X) 
3% PRINT xX 
4g GOTO 19 
RUN 
216 

4 

?199 

1g 

?1 92D 
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31.6228 
2123456789 
Le 1 

?17 
4.12311 
?25E2 

59 
21978 
44.3847 
? (RETURN) 
READY 


IV. Exponential Function, EXP (x) 


The exponential function raises the number e to the power x. EXP is 
the inverse of the LOG function. The relationship is 


LOG(EXP(X)) = X 


The following program prints the exponential equivalent of an input 
value. Note that the output values derived below are used as input to 
the LOG function. 


19 INPUT x 
2@ PRINT EXP(X) 
4% GOTO 19 


RUN 
24 
54.5981 
?1¢ 
22826.5 
2?9.421996 
12345 
2?4.69517 
199 
225 
7. 2GG49E+19 
? (RETURN) 
READY 


Vis Logarithm Function, LOG(x) 


The LOG function derives the logarithm to the base e of a given value. 
In the following program at line 20, the LOG function is used to 
convert an input value to its logarithmic equivalent. 


19 INPUT xX 
2% PRINT LOG(X) 
38 GOTO 19 


RUN 
254.59815 

4 

2229.26.47 

1p 45 


212345 
9.42181 

2190 
4.69517 

?. 72GG49E11 
25 

? (RETURN) 

READY 


Logarithms to the base e may easily be converted to any other base 
using the following formula: 


log,N 
log,N= 
log,a 


where a represents the desired base. The following program illustrates 
conversion to the base 10. 


1 REM - CONVERT BASE E LOG TO BASE 19 LOG. 
5 PRINT "VALUE","BASE E LOG","BASE 1 LOG" 
15 INPUT x 
17 PRINT xX, 
20 PRINT LOG(X), 
4% PRINT LOG(X) /LOG (19) 
5% GOTO 15 
6% END 


VALUE BASE E LOG BASE 18 LOG 


4 1.38629 .6 9286 
2250 

250 5.52146 2.39794 
25 

5 1.69944 .69897 
260 

69 4.99434 1.77815 
2189 

199 4.68517 2 

? (RETURN) 
READY 


An attempt to do a LOG(0) or LOG of a negative number causes the 
CF error message. 


Vin. Absolute Function, ABS (x) 
The ABS function returns an absolute value for any argument value. 


Absolute value is always positive. In the following program, various 
input values are converted to their absolute values and printed. 
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19 INPUT x 
28 LET X = ABS(X) 
39 PRINT X 
49 GOTO 19 
/RUN 
2?-35.7 
35.7 
@2 
2 
?25E19 
2. 59GOPE+11 
2195555567 
1.95556E+98 
219.12345 
ple sa 
2-44 .555566668899 
44.5556 
? (RETURN) 
READY 


Vide. Integer Function, INT(x) 


The integer function returns the value of the greatest integer not 
greater than x. For example: 


PRINT INT (34.67) 
34 


PRINT INT(-5.1) 
-6 


The INT of a negative number is a negative number with the same or 
larger absolute value, i.e., the same or smaller algebraic value. 


For example: 


PRINT INT (-23.45) 
-24 


PRINT INT(-14.39) 
-15 


PRINT INT(-11) 
-11 


The INT function can be used to round numbers to the nearest integer, 
using INT(X+.5). For example: 


PRINT INT (34.67+.5) 
35 


PRINT INT(-5.1+.5) 
=5 
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INT(x) can also be used to round to any given decimal place or 
integral power of 10, by using the following expression as an 
argument: 


(X*107D+.5)/10 D 
where D is an integer supplied by the user. 


19 REM - INT FUNCTION EXAMPLE 

15 PRINT 

2¢ PRINT "NUMBER TO BE ROUNDED:" 
25 INPUT A 

4% PRINT "NO. OF DECIMAL PLACES:" 
45 INPUT D 

69 LET B = INT(A*1OAD + .5)/1@aD 
78 PRINT "A ROUNDED = " B 

8% GOTO 15 

99 END 

RUN 


NUMBER TO BE ROUNDED: 


?55.65842 
NO. OF DECIMAL PLACES: 
22 


A ROUNDED = 55.66 


NUMBER TO BE ROUNDED: 
276.375 

NO. OF DECIMAL PLACES: 
G29 

A ROUNDED = 199 


NUMBER TO BE ROUNDED: 
267.38 

NO. OF DECIMAL PLACES: 
Pol 

A ROUNDED = 79 


NUMBER TO BE ROUNDED: 
? (RETURN) 
READY 


VIII. Random Number Function, RND(x) Repeats otter 995 number's. 


The random number function produces a random number, or random number 
set, between 0 and 1. The numbers are reproducible in the same order 
after ESC, E key if X»0 for later checking of a program. The argument (x) 
is not used and can be any number (it cannot be a string expression); it 
serves only to standardize all BASIC 8001 function representations. The 
form RND is not legal. For example: 
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19 REM - RANDOM NUMBER EXAMPLE. 

25 PRINT "RANDOM NUMBERS: 

30 FOR I = 1 TO 15 

4% PRINT RND(1)3 

5% NEXT I 

6% END 

RUN 

RANDOM NUMBERS : 
.198258.59438  .964813.9267824 .886627.388994 .636444.569123 .839919.729821 
.396121.299946 .285553.599886 .958221.744955 .179351.469434 .452117.433291 
.985412.27376  .522186.791146 .246246.5998584 .777891.457448 .459592.39797 


READY 
To obtain random digits from 0 to 9, change line 40 to read: 
48 PRINT INT(10*RND(1)), 


and run the program again. This time the results will be printed 
as follows: 


RUN 

RANDOM NUMBERS : 

8 9 8 9 5 5 5 9 8 7 
5 4 4 1 5 

READY 


It is possible to generate random numbers over a given range. If 
the open range (A,B) is desired, use the expression: 


(B-A) *RND(1)+A 
to produce a random number in the range A<n<B. 


The following program produces a random number set in the open range 
4,6 (the extremes, 4 and 6, are never reached). 


18 REM - RANDOM NUMBER SET IN OPEN RANGE 4,6. 
28 FOR B = 1 T0 15 

39 LET A (6-4) * RND(1) +4 

49 PRINT A, 

50 NEXT B 

6% END 


RUN 

4.29954.59266 5.929624.29985 5.773255.54926 5.272884.76248 5.678945.25946 
4.612245.33846 4.571194.26695 5.916445.69965 4.358795.54721 4.984235.65821 
4.197985 .99934 5.944374.82533 4.492495.61498 5.555694.41632 4.991185.91598 


READY 
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NOTE: 
number sequence. 


Negative arguments, i.e., RND(-x) will start a new random 
While RND (%) will always generate the last random 


nays AND (-X) will always restart the same random number sequence # 


IX. Sign Function, SGN(x) 


The sign function returns the value 1 if x is a positive value, 9g 


if x is O and -l if x is negative. 


PRINT SGN(3.42) 
1 


PRINT SGN(-42) 
=1 


PRINT SGN (23-23) 
g 


For example: 


The following example program illustrates the use of the SGN function. 


1Q REM-SGN FUNCTION EXAMPLE. 
20 READ A,B,C 


25 PRINT "A = "A,"B = "B,"C = "C 

38 PRINT "SGN(A) ="SGN(A), "SGN(B) ="SGN(B), 
4g PRINT "SGN(C) ="SGN(C) 

59 DATA -7.32, .44, @ 

69 END 

RUN 

A= -7.32 B= .44 c= 9 


SGN(A) =-l SGN(B) =1 SGN(C) 
READY 
x. Call Statement 


g 


The CALL statement can be inserted anywhere in the BASIC 8001 program 


and has the form: 
CALL (expression) 


Where expression 


is the argument to the assembly 
language routine. The argument 
may be an expression. This may 
include values passed to the user 
routine. 


The CALL statement causes a jump to location AO00 HEX, which, unless 


modified by the user, contains a jump to the CF ERROR routine. 


The 


user must modify these three locations to go to his routines. 
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BASIC 8001 FUNCTIONS 


USER DEFINED FUNCTIONS 


In some programs it may be necessary to execute the same sequence of 
statements or mathematical formulas in several different places. 
BASIC 8001 allows definition of unique operations or expressions and 
the calling of these functions in the same way as the square root or 
trig functions. 


These user-defined functions consist of a function name: the first 
two letters of which are FN followed by a third or a fourth letter. 
For example: 


legal illegal 
FNA FNAS 
FNAA FN2 
FNAL 


Each function is defined once and the definition may appear anywhere 
in the program. The defining or DEF statement is formed as follows: 


DEF FNa (argument) = expression (argument) 
where a is a variable name. The argument may consist of a dummy variable 
and the number of arguments is limited to one variable. The expression 
may contain other program variables not among the argument variable. 
For example: 

10 DEF FNA(S) = SA2 
causes a later statement: 

20 LET R = FNA(4)41 


to be evaluated as R=17. As another example: 


59 DEF FNB(A) = A+XA2 
6% Y=FNB (14) 


causes the function to be evaluated with the current value of the 
variable X within the program. 


The two following programs 
Program #1: 
19 DEF FNS(A) = AAA 
29 TOR T=] TO 5 
39 PRINT I, FNS(I) 


4 NEXT I 
59 END 
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Program #2: 


1 DEF FNS(X) = XAaX 
28 FOR I=1 TO 5 

3% PRINT I, FNS(I) 
4 NEXT I 

5% END 


cause the same output: 


RUN 
HE L 
2 4 
3 27 
4 256 
5 3125 
READY 


The argument in the DEF statement can be seen to have no significance; 

it is strictly a dummy variable. (A DEF statement with no arguments is 
illegal.) The function itself can be defined in the DEF statement in 
terms of numbers, variables, other functions, or mathematical expressions. 
For example: 


1Q DEF FNA(X) = XA2+3*X+4 
2 DEF FNB(X) = FNA(X)/2 + FNA(X) 
38 DEF FNC(X) = SOR(X+4) +1 


The statement in which the user-defined function appears can have that 
function combined with numbers, variables, other functions, or mathe- 
matical expressions. For example: 
4Q LET R = FNA(X+Y+Z) *N/ (YA2+D) 
A user-defined function cannot have several arguments, as shown below: 
25 DEF FNL(X,Y,Z) = SOR(XA2 + YA2 + ZA2) 


will cause an error 


SN ERROR IN 25. 
READY 


When calling a user-defined function, the parenthesized arguments can be 
any legal expressions. The value of each expression is substituted for 
the corresponding function variable. For example: 

19 DEF FNZ(X)=Xa2 

20 LET A=2 

38 PRINT FNZ(2+A) 


line 30 causes 16 to be printed. 
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If the same function name is defined more than once, then the last 
definition will be used. The program below 


1Q DEF FNX(X)=XA2 
2@ DEF FNX(X)=X+X 
38 LET A=5 

4g PRINT FNX(A) 


will cause 10 to be printed. 


The function variable need not appear in the function expression as 
shown below: 


10 DEF FNA (X) = 4 +2 
20 LET R = FNA(10) +1 
30 PRINT R 

40 END 

RUN 

7 
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BASIC 8001 FUNCTIONS 


STRING FUNCTIONS 


Like the intrinsic mathematical functions (e.g., SIN, LOG), BASIC 8001 
contains various functions for use with character strings. These 
functions allow the program to concatenate two strings, access part of 
a string, determine the number of characters in a string, generate a 
character string corresponding to a given number or vice versa, search 
for a substring within a larger string, and perform other useful 
operations. The various functions available are summarized in the 
following table. 


String Functions 


Function code Meaning 


ASC (xS$) Returns the seven-bit internal code for the 
one-character string (x$) as a decimal num- 
ber. If the argument contains more than 
one character, then the first character in 
the string is returned. 


CHRS (x) Generates a one-character string having the 
ASCII value of x where x is a number greater 
than or equal to O and less than or equal to 
255. For example: CHRS$(65) is equivalent 


to "A". Only one character can be generated. 

FRE (x$) Returns number of free string BY 

LEFTS (x$,I) Returns left most I characters of string 
(x$). 

LEN (x$) Returns the number of characters in the 
string x$ (including trailing blanks). For 
example: 

PRINT LEN (AS) 
26 
MIDS (x$,I,Jd) Returns the string of characters in position 


I through J in xs. 


RIGHTS (x$,1I) Returns right most I characters of string 
(x$). 
STRS (x) Returns the string which represents the 


numeric value of x as it would be printed by 
a PRINT statement but without a leading or 
trailing blank. 
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VAL (x$) Returns the number represented by the string 
x$. If x$ does not represent a number, then 
@ value is returned. 


In the above examples, x$ and yS represent any legal string expressions, 
and I and J represent any legal arithmetic expressions. 


User-Defined String Functions 


Character string functions cannot be written in the same way as numeric 
functions. 
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BASIC 8001 EDITING COMMANDS 


BASIC 8001 provides several key commands which can be used to halt 
program execution, erase characters or delete lines. The below table 
provides an explanation of each of the key commands. 


Key Commands 


Key 


CTRL/J 
or LINEFEED 


or a 


CTRL/M or RETURN 


CTRL/K 
‘Or 
ERASE LINE 


CTRL/Z 
or CURSOR LEFT 
or ee 


CTRL/L 
or ERASE PAGE 


Explanation 


Interrupts execution of a command or program. 
BASIC 8001 prints the message 


BREAK IN XXX 
READY 


A control command is typed by holding down 
the CTRL key while typing the letter key. 


Must be typed to end every line typed in 
or to indicate the end of an INPUT. 


Deletes the entire current line (provided 
the RETURN key has not been typed). 
BASIC 8001 displays: 


Erased line and CR. 


Deletes the last character typed and echoes 
aS a cursor left on the terminal. Snaces 
as well as characters or control cc es may 
be erased. 


A colon is used to separate multiple 
statements per line. 


Erases CRT screen but does not change 
any BASIC 8001 statements. 


If the RETURN key has already been typed, a program line can be corrected 
by typing the appropriate line number and retyping the line correctly. 


The line can be deleted by typing the RETURN key immediately after the 
line number; removing both the line number and line from the program. 


If the line number of a line not needing correction is accidentally typed, 


the cursor left key (CTRL Z) may be used to delete the number(s); then the 
correct number can be typed. Assume the line: 
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1f IF A?5 GO TO 239 

is correct. A line 15 is to be inserted, but: 
1Q LET 

is typed by mistake. The correction is made as follows: 
19 LET@¢€€5 LET X=x-3 

Line 10 remains unchanged, and line 15 is entered. 


Following an attempt to run a program, error messages may be output 
on the terminal indicating illegal characters or formats, or other 
user errors in the program. Most errors can be corrected by typing 
the line number(s) and the correction(s) and then rerunning the pro- 
gram. As many changes or corrections as desired may be made before 
runs. 


The following editing commands are entered in immediate mode and 
terminated by the RETURN key. These commands are used to erase a 
program in RAM, and list, punch or run a program. 


alee NEW COMMAND 

The NEW command clears current contents of the storage area set up 
by BASIC 8001. This deletes any commands, programs, arrays, strings 
or symbols currently stored by BASIC 8001. 

NEW should be used before entering a new program from the terminal 
keyboard to be sure no old program lines will be mixed into the new 


program and to clear out the symbol table area. 


Example: 


clears the storage area and inserts the program being input at the 
keyboard. 


Els LIST COMMAND 


The LIST command prints the user program currently in core on the 
terminal. 


A part of a program may be listed by typing LIST followed by a line 
number. This causes that line and all following lines in the program 
to be listed. 
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Type CTRL/J or linefeed key to halt the listing. BASIC 8001 returns 
to the READY message when the current line is finished. 


The lines listed may differ slightly from those entered because: 


1. Certain characters while acceptable to BASIC 8001 are stored 
in a standard manner. 


Character Character 
Typed Stored 
=€ <= 
=? >= 
>< <? 


2. Literals are stored to 24 bits of accuracy. Those with more 
than 24 bits are truncated to 24 bits. 


3. Although literal storage is 24 bits, output is truncated to 
6 decimal digits. 


4. Literals are output in standard BASIC 8001 format, regardless of 
how they were input; for example, 


1M LET X=3.9+1. 9909991 
28 PRINT X-E7 

LIST 

19 LET xX=3+1 

29 PRINT X-1.PPPPGE+97 


5. Spaces in the input program are ignored, except within 
strings and REM statements. The LIST command prints the 
program with a space inserted to separate the key word and 
the line number. The listed program is therefore easier 
to read. 

Example: 
LIST 199 
Lists line 100 and all remaining lines in the program. 


TEL. SAVE COMMAND 


The SAVE command outputs the program in RAM to the specified device. 
The form of the command is: 


SAVE A 
The format of the program output by the SAVE command is exactly the 


same as that stored in RAM memory. It may be recalled by the same 
file name using the LOAD command. 
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IN RUN COMMAND 


After the user program is entered into RAM, it can be executed by 
typing the command 


RUN 
and the RETURN key. 
The program is scanned; arrays are created in core and then the program 
is executed. Any appropriate error messages are printed and when the 


END or STOP statement is encountered, execution halts and a message is 
printed. 


After execution, the variables used in a program remain accessible for 
use in immediate mode until a NEW, CLEAR or another RUN command is 
executed. 


Vi CLEAR COMMAND 
The CLEAR command clears the contents of the user array and string 
buffers. This command is generally used when a program has been exe- 
cuted and then edited. Before it is rerun, the array and string buffers 
are set to zeros and nulls by the CLEAR command to provide more core. 
These buffers will be filled again when the RUN command is executed. 
Example: 

19 A=19 

28 PRINT A 

CLEAR 


READY 


RUN 
19 


READY 
Wee CLEAR X COMMAND 
The CLEAR X performs the same function as CLEAR without the argument, 
but the Argument X reserves X locations for string variables which are 
required in string calculations. Normally this is 50 locations unless 
changed by CLEAR X command. 

Vit. CONTINUE COMMAND 

Continues program execution after a Control J or line feed is typed or 


a STOP statement is executed. You cannot continue after any error, after 
modifying your program or before your program has been run. 
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One of the main purposes of CONT is debugging. Suppose at some point 
after running your program, nothing is printed. This may be because 
your program is performing some time-consuming calculation, but it may 
be because you have fallen into an "infinite loop". An infinite loop 

is a series of BASIC 8001 statements from which there is no escape. 

The BASIC 8001 will keep executing a series of statements over and 

over until you intervene or until power to the unit is cut off. If 

you suspect your program is in an infinite loop, type in a Control J 

or line feed. The line number of the statement BASIC 8001 was executing 
will be typed out. 


After BASIC 8001 has typed out READY, you can use PRINT to type out 
some of the values of your variables. After examining these values, 
you may become satisfied that your program is functioning correctly. 
You should then type in CONT to continue executing your program where 
it left off, or type a direct GOTO statement to resume execution of 
the program at a different line. 


You could also use assignment (LET) statements to set some of your 
variables to different values. Remember, if you line feed or Control 
J your program and expect to continue it later, you must not get any 
errors or type in any program lines. If you do, you won't be able to 
continue, and get a "CN" (continue not) error. It is impossible to 
continue a direct command. CONT always resumes execution at the next 
statement to be executed in your program when Control J or line feed 
was typed. 


VIII. LOAD I COMMAND 


LOADS the program named I from the 8001 CPU operating system Reader 
Input port specified by the I/O BYTE at location 9F90 HEX, see the 
CPU O.S. Manual. A new command is automatically done before the 
LOAD I command is executed. When finished loading the READY command 
will appear as usual. If the unit can't find the file on the floppy 
tape, then an error message should appear. 


IX. LOAD?I COMMAND 

Does same as LOAD I except that a NEW command is not performed and 
BASIC 8001 does a word-by-word comparison of file I with the program 
already existing in RAM memory. If they are the same, then READY 


appears, else 


VERIFY FAILURE 
READY 


will appear. 
This should always be used after saving a program with the SAVE I 


command to ensure that it was saved correctly and can be reloaded 
without error. 
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SPECIFICATIONS 
Introduction 


The ieee 8001 is an eight color intelligent CRT data terminal 
designed as a replacement for teletypes and black and white CRT data terminals. 
It is a self-contained, desk top unit which offers, with the use of a modem, 
two-way data communications over common voice telephone lines or teletype 
compatible current loops. It can also be used in the stand alone mode as a 
complete desk top computer if equipped with the proper options. 


Basic System Specification 


Power: 105-125 volts, 60HZ, 250 watts 
Option 11: 205-250 volts, 50-60 HZ 


Temperature: +10°C to +40°C operating 
-30°C to +70°C storage 


Humidity: 0 to 95% non-condensing 
Package Size 17 1/2" high 

Desk Mount 19 3/8" wide 

Version: 22 1/2" long 

Keyboard 3 1/4" high 

Dimensions: 14 1/16" wide x 5 1/2" deep 
Weight: 85 pounds 

Screen 19" diagonal measure 

Size: 186 sq. inch screen area 


4x3 aspect ratio 


Display 120 sq. inches 

Area: (12.0" wide x 10.0" high) 

Character 80 characters per line, 25 lines per page 
Format: Option 16: 80 characters per line, 


48 lines per page 


Character 64 ASCII Characters, 5x7 dot matrix 

Style: within a 6x8 dot pattern 
Option 03: 32 Graphic Characters, 6x8 dot matrix 
Option 17: 64 Graphic Characters, 6x8 dot matrix 


Standard Interface 
Standard I/O Ports 


The standard Intecolor 8001 has two input ports. 

One port, Jl, is an asynchronous serial RS 232C I/O, or if Option 
07 is installed, a serial 20 ma current loop I/O. The other port, J2, 
accepts parallel input data from the keyboard and provides an 8 bit parallel 
output. The Intecolor® g001 is furnished with a crystal clock and provides 
a keyboard selectable baud rate of normal 110, 150, 300, 1200, 2400, 4800, 
and 9600 baud, or a high speed option of 880, 1200, 2400, 9600, 19,200, 
38,400, and 76,800 baud. 


The serial input port is furnished without parity checking so 
that when in the Plot Mode, or CCI Mode, eight data bits can be received. 


The signals for the standard RS 232C I/O ports are shown on 
page 3 and on Jl and J2 in Appendix A7. 


Pin 2 of the Keyboard J2 connector signals the Data communications 
equipment that the terminal has received a byte and is processing the last 
byte received. The Unit's input port has a one byte buffer. So for maximum 
speed, the communications equipment can send the next byte as soon as it 
has detected the high to low transition on pin 2. The wave form is shown 
below: 


3.5V Approx. 70 MICRO SECONDS 


Next byte may be sent after high 
to low transition. 
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START-UP AND INITIALIZATION 
Introduction 


BEFORE ATTEMTPING TO OPERATE YOUR InTECOLOR® 001, IT 15 
SUGGESTED THAT THIS SECTION BE READ AND UNDERSTOOD. The power switch 
(SW1) is located in the lower rear panel portion of the CRT case. Also 
located on this panel are the various input and output port connections. 
These are shown in Appendix A8. Connection diagrams are shown in Appendix 
A7. 


Power 


Plug the line cord into a 120VAC-60HZ outlet (230VAC-50-60 HZ 
with Option 11). When the power switch is pushed up the terminal is -_ 
in the operating state. After the switch is turned on, a 60 second warm 
up perigd is required before operating the terminal. The unit will come 


up in the initialized state, S,. a 


Initialized State - So 


The unit will always come up in the initialized state-S, when 
power is turned on after being off for at 4east 30 seconds. 


In State es the following conditions are true: 


A. Visible foreground color = white 

B. Visible background color = black 

Cs Reverse field flag = "0" 

D. Visible A7 bit = "0" (unless otherwise noted) 

E. Plot Bit = "0" . 
Ei. Page Mode Operation (unless otherwise noted) 

G. Terminal Mode = Local (unless otherwise noted) 

H. Baud Rate = 9600 with one stop bit (unless otherwise noted) - 
I; Write left to right with visible cursor 

es Blind foreground color = red 

K: Blind background color = black 

L. Blind A7 Bit = "Oo" = 
M. Blind Plot Bit = "oO" 

N. Blind Cursor at home or top left corner of screen. 


After the above conditions have been set, the cursor is moved 
to the home position which is the top left hand corner of the screen, and 
the position of the first character of the first line. The screen will 
clear by an Erase Page command which effectively makes all 2000 (3840 with 
80 character x 48 line option) characters; spaces (20 HEX) which are white, non- 
blinking (@7 HEX). The unit is now ready to accept commands from the keyboard 
or the serial input if connected. . = 


Convergence and Purity 
The units convergence and purity may need adjusting when initially 
received. Allow at least a 30 minute warm before setting the final convergence. 


See Appendix C for convergence alignment. 
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SUMMARY OF CONTROL CODES 
FOR INTECOLOR 8001 


NULL (control @) has no effect. 
PROTECT (control A) has no effect. 
PLOT (control B) enters graphic plot mode (see plot submodes). 


CURSOR XY (control C) enters X-Y cursor address mode for either 
visible cursor or blind cursor. 


FREE (control D) not used - has no effect. 
FREE (control E) not used - has no effect. 


CCI (control F) the next character which follows provides the 8 bit 
visible status word. 


BELL (control G) provides a 150 ms tone. [continuous Jone,| 
HOME (control H) moves the cursor to top left corner of display. 


TAB (control I) causes cursor to advance to next column - the tab 
columns are every 8 characters. 


LINE FEED (control J) causes the cursor to move down one line. 


ERASE LINE (control K) causes the cursor to return to beginning of line 
and causes the complete line to be erased. 


ERASE PAGE (control L) causes the complete screen to be erased and 
the cursor moves to the home position. 


RETURN (control M) causes the cursor to move to the beginning of the 
line it presently is on. 


A7 ON (control N) turns the A7 bit flag on. PLorT BIG LETTE esl 


BLINK/A7 OFF face O) turns the blink bit and A7 bit off. 

BLACK KEY (control P) sets either foreground or background to color black. 
RED KEY (control 0) sets either foreground or background to color red. 

GREEN KEY (control R) sets either foreground or background to color green. 
YELLOW KEY (control S) sets either foreground or background to color yellow. 
BLUE KEY (control T) sets either foreground or background to color blue. 


VIOLET KEY (control U) sets either foreground or background to color violet. 
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CYAN KEY (control V) sets either foreground or background to color cyan. 
WHITE KEY (control W) sets either foreground or background to color white. 
XMIT (control X) causes data to be transmitted from the visible cursor 
to the end of page or until FF/OO is found in Refresh 
RAM. 
CURSOR RIGHT (control Y) causes the cursor to move right 1 position. 


CURSOR LEFT (control Z) causes the cursor to move left 1 position. 


ESC (control L ) provides an entry to the escape code table- must be 
followed by one or more codes for proper operation. 


CURSOR UP (control \) causes the cursor to move up one line. 
FG ON/FLAG OFF (control_] ) sets the flag bit off. : 
BG ON/FLAG ON (control /\) sets the flag bit on. 


BLINK ON (control — ) sets the blink bit on. 
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5 BIT CODE 


SUMMARY OF ESCAPE CODES 


FOR INTECOLOR 8001 


LETTER 


@ 


FUNCTION 

Visible cursor mode 

Blind cursor mode 

Plot via color pad 

Transmit cursor X,Y position 

Not used 

Re-entry to BASIC 8001 

Sets full duplex mode 

Not used 

Sets half duplex mode 

Not used 

Set write vertical mode 

Sets roll up and write left to right mode 
Sets local mode 

Not used 

Not used 

Re-entry to the CPU operating system 


Initializes and transfers control to 
the CPU operating system 


¥ Character insert mode 
Baud rate selection mode 
A7 on = 1 stop bit, A7 off = 2 stop bit 
Transfer control to the 8080 assembler 
Transfer control to the text editor 
Insert one line 


Delete one line 


Initializes and transfers control to 
BASIC 8001 


5 BIT CODE LETTER FUNCTION 


24 xX Sets page mode and write left to right 
mode 

25 Y Test mode - fill page with next character 

26 Z Set write down on 45 degree mode 

27 cE Not used 

28 \ Sets write up on 45 degree mode 

29 a Set unit up for Block receive mode 

30 aN Causes a jump to address 9FAZH 

31 — Transfer control to the CRT mode 


* Must include certain option to be operational 


SUMMARY OF GRAPHIC PLOT SUBMODES 


FOR INTECOLOR 8001 


OPTIONAL 

RS-232 INPUT PLOT NORMAL KEY- FUNCTION 
CODE SUBMODE BOARD CODE KEYBOARD CODE 

255 Plot Mode Escape Control ? F 15 
254 Charactor Plot Control > F 14 
253 X Point Plot Control = F 13 
252 Y Point Plot Control & F 12 
251 X-Y Incremental Point Plot Control ; F 11 
250 Xo of X Bar Graph Control : F 10 
249 Y of X Bar Graph Control 9 F 9 
248 X max of X Bar Graph Control 8 F 8 
247 Incremental X Bar Graph Control 7 F 7 
246 Yo of Y Bar Graph Control 6 F 6 
245 X of Y Bar Graph Control 5 FOS 
244 Y max of Y Bar Graph Control 4 F 4 
243 Incremental Y Bar Graph Control 3 E33 
242 Xo Vector Plot Control 2 F2 
241 Yq Vector Plot Control 1 Ei 
240 Incremental Vector Plot Control @ F @ 


SUMMARY OF INCREMENTAL DIRECTION CODES 
FOR INTECOLOR 8001 


CRT REFRESH MEMORY LAYOUT 


The 2000 [3840] * characters for display are stored in a 4096 
[s192] word RAM memory beginning at 32,768 (8000 HEX) and ending at 
36,767 (8F9F HEX) [40,447 (9DFF HEX)] . The first word is the 
zero character stored as the A. bit and then the 7 bit ASCII code 
(Ag to Aj). The second word is the compositestatus for this character. 
It is composed of Plot Character Bit (Az), Foreground Blink (Ag) + Back- 
ground color code (Ac, Ag, A3), and Foreground color code (Aj, Al, Ao) - 


Therefore, each screen character requires two 8 bit words in 
memory, (the screen character and the character's compositestatus). The 
RAM memory location 8FAO HEX [9FA%]to 8FFF HEX [9FFF HEX] are used for 
scratch pad storages. Memory location 8FBO ForBo HEX] and 8FB1 (9FB1 | 
are the locations of the Cursor character position and line number 
respectively. With the Roll Mode (Option 15) memory location SFB2 [9FB2 ] 
provides the number of lines that the home position has been shifted or 
rolled. 


Ls [Indicates value for 48 Line system] 


1A 
REFRESH MEMORY WORD FOR ONE CHARACTER 
EVEN ODD = (EVEN +1) 
ASC II Code 
BLINK FOREGROUND 
|BIT }e Gc B | COLOR 


PLOT BITS pion | ee B G R | 


BIT | COLOR 
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Keyboard 


The Intecolor 8001 has a detachable keyboard which presents 
the standard ASCII four level code. (See Appendix A-1 for keyboard layouts) . 
The keyboard keys are optically encoded by means of phototransistors, a 
light source and shutters attached to the keys. There are no switches 
to wear out and the unit is RFI free. The Keyboard does not provide 
two key rollover. 


CPU Reset 


The CPU Reset key provides a reset signal to the 8080 CPU. 
Its primary function is to allow the operator to regain control of the 
terminal if the software the customer has installed gets hung in an 
endless loop. If the reset is operated properly the bell will issue a 
short beep upon the release of the key. If automatically forces the 
terminal to the S_ state. That is, just as if the power had been turned 
off and then back on. If additional RAM memory is installed this memory 
area is not cleared, but the scratch RAM area within the CRT Refresh RAM 
card is cleared. 


Control Key 
The control key must be held down while the proper alpha numeric key 


is depressed if a control function is desired. The control functions are either 
color coded or have its desired results engraved oh top of the key. Those keys 


which have a name enclosed within a ( ) parentheses indicate that they are also 
standarized escape codes. The escape codes only require that the ESC key 
be depressed then the ( ) parentheses key desired, 

Shift Key 


The shift key must be held down while the proper alpha numeric key 
is depressed if a shifted function is desired. Note that both the control and 
shift key must be held down to generate certain codes from the keyboard using 
the alpha numeric keys. See Appendix A-2 for the keyboard code set. 
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DETAIL OF CONTROL CODES 


All of the display commands can be entered either through the 
serial input port or the keyboard. The keyboard input port has the highest 
priority of all inputs or outputs. The eight bit Intecolor 8001 code 
set as shown in Appendix A-2 must be used for the serial input port. The display 
control commands are a subset of the 32 ASCII control code set, and a flow 
diagram of these commands is shown in Appendix A-3. 


With some display commands, such as the Graphic Plot Mode, 
delays may be experienced at the higher baud rates. A chart for these 
delays is shown in Appendix A4. 


The Intecolor 8001 display commands has been expanded by 
an additional 32 commands via the ESC, character sequence as shown in 
Appendix 5. The terminal employs two input pointer flags, one for the 
keyboard and one for the RS232C input. Each flag may point to a 
different Mode of operation and thus the terminal can act differently 
from the keyboard as compared to the RS232 input. (See blind cursor 
eperation Code 1 on page 19 .) 


Code @ Null - (Control @) 
Has no effect upon the display 
Code 1 Protect * (Control A) 


Not presently implemented so it has no effect upon the 
unit. 


Code 2 Graphic Plot Mode - (Control B) =— (Option 02) 


The general Graphic Plot Mode is entered by a 
binary code 2 or a Control Code B. (See Appendix B). It should be 
noted that the XY Plot Mode is also entered at the same time. If a 
plot mode other than XY Point Plot is desired, the next word that follows 
should then be a binary code from 240 to 255. These codes represent 
the various plot submodes as shown in the summary of Graphic Plot Submodes. 


An additional feature is available to allow a graphic plot to 
be erased by simply setting the Flag bit on before entering the plot mode. 
This causes an XOR function to exist when plotting. Therefore, if you 
plot the same point, bar or vector twice, the second time erases the 
original. 


. Once in the general Plot Mode, any of the plot submodes 
may be entered by sending the corresponding code to the terminal. When 
this code is received, a flag internal to the terminal, known as PLOFL, 

is set placing the terminal in the appropriate plot submode. It should 

be noted that in many of the plot submodes, PLOFL is automatically set to 
a different value upon completion of the operation of that submode causing 
the terminal to enter a new submode. This is done to make coding and 
operation of the terminal in the various plot functions easier for the 
operator. The various submodes and their interactions are explained in 
detail in Appendix B. 
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Code 3 Cursor X-Y (Control C) 


The visible cursor may be positioned any where on the 
screen simply by sending a 3-word sequence beginning with 03. The 
next two words that follow determine that X character position (0-79) 
and Y line position (0-24) for 25 line unit or [0-47] for 48 line unit. 
Both X and Y values must be in binary form with the range indicated. 
The cursor home position (i.e., the top left hand corner) is position O, O 
while the bottom right hand corner is (79, 24) or (79, a7]. 


If the cursor is positioned at X = 80 binary (50 HEX) then the cursor will 
disappear. But if a character is typed it will be positioned at the 
beginning of the line specified by Y + 1, the cursor then reappears in 
character position 1. Any cursor command will automatically force the 
cursor to reappear at the proper position in relation to character position 
0, dine: Y + 1. 


If the cursor X values is 81 binary (51 HEX) or larger then 
the CRT ignores this as the visible cursor X values and sends the 
unit into the blind cursor addressing mode. Once in the blind cursor 
X-Y addressing mode three (3) additional words must be sent. They are 
blind cursor X value, blind cursor Y value, and the blind status word. 
The blind X value must be in the_range of 0-79 and the blind Y value 


must be in the range of 0-24 or [o-47] : The blind status word must 
be in the same format as required in the CCI mode (control F). See the next 
page, 


The blind A7 bit will be set on by sending from 128 binary to 
255 binary instead of 81 binary when going from the visible cursor 
X,Y mode to the blind cursor X,Y mode. The Blind A7 bit will be set off 
anytime a binary number between 81 and 127 is used to get into the blind 
X,Y mode. 


It should be noted that _the X and Y cursor values received 
are masked to 0-127 and 0-31 jo-63] respectively. Then, if the value is 
still out of range, the X value has 80 subtracted and the Y values has 25 
[48] subtracted. 


When exiting from the blind cursor X-Y mode the terminal is 
left in the blind cursor mode for what ever input device caused the 
mode to be entered. That is if after CPU reset is operated the keyboard 
causes the blind cursor XY to be addressed then the keyboard will be 
left in the blind cursor mode while the RS232 serial is still in the 
visible cursor mode. 


Code 4 EOT - (Control D) 


Has no effect upon the display 


Code 5 ENO - (Control E) 


Has no effect upon the display 


13 


Code 6 CCI - (Control F) 


When this code is received the system accepts the next 
eight bit word from the serial input as the new compositestatus for the 
characters which follow. See CRT Refresh Memory Section. 


The first three bits represents the Foreground Color with 
Red, =Ag, Greenp,=A), and Blue =A, The next three bits represent the 
Bae maeaond Color (optional) wien Redp= A3, Greenp=Aq, and Bluep=Az . The next 
bit, Ag iS the Blink bit for the Foreground Color and the last bit, A7 is Plot 
Character bit which causes the display to interpret the ASCII word as a 2x4 plot 
array. 


Code 7 Bell - (Control G) 


When this code is received a tone will sound for about 150 MS. 


5 on until BASIC pregram rene s an END. or INPUT...30 4 loo 
bak be used to inelng se tene A END p 
Code 8 Home —~ (Control H) 


When this code is received the cursor moves to 0,0 or the 
top left hand corner of the screen. 


Code 9 Tab - (Control I) 


When this code is received the cursor moves horizontally 
to the next tab position. The tab positions are fixed and are at 
every eight positions from zero. 


Code 10 Line Feed - (Control J) 


When this code is received the cursor moves down one line. 
This is the only code used for cursor down. 


Code 11 Erase Line - (Control kK) 


When this code is received a carriage return is initiated and 
the characters from the beginning to the end of the line are replaced with 
spaces and have the same color and status as the present visible CCI 
status. The cursor is always positioned at the beginning of the line. 


Code 12 Erase Page - (Control L) 


When this code is received the complete screen is replaced 
with spaces that have the same color and composite status as the present 
visible CCI status. The cursor always returns to the Home position. The blind 
cursor is also positioned at home. 


Code 13 Carriage Return —- (Control M) 


When this code is received, the cursor returns to the beginning 
of the line that it presently is on. 
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Code 14 Ay On - (Control N) 


Upon receiving this code, the characters which are to be 

This bit is used to allow 2X 

This effectively doubles the number of 
displayable character types from 128 to 256. 


displayed have Az forced to a "1". 
character sizes for 48 line units. 


Code 15 Blink - Az - OFF 


(Control 0) 


When this code is received the characters which follow have 
Az set to "0" (1.¢e., Opposite to A, On as above) and also have the 


Blink bit, Ag of the composite status for the character set to "0" 
(i.e., the opposite of Blink-On per Code 31.) 


Code lo to 23 or Color Keys 


Black (Control 
Red (Control 
Green (Control 
Yellow (Control 
Blue (Control 
Magenta (Control 
Cyan (Control 
White (Control 


P) 
Q) 
R) 
S) 
T) 
U) 
Vv) 
W) 


Code 
Code 
Code 
Code 
Code 
Code 
Code 
Code 


When one of these eight codes is 
things happens, depending upon the Flag bit. 
the key that is depressed will change the compositestatus to that 


Foreground Color code. 


16 
17 
18 
19 
20 
Zi) 
22 
23 


There are eight color keys 


A, A, Ao 
0 0 0 
0 0 1 
0 il 0 
0 1 at 
1 0 0 
i 0 1 
if ae 5 
i 1 1 


received then one of two 


If the Flag is off then 


If the Flag is on, then the key that is depressed will change 
the compositestatus to the Background Color code. If Background 
Color option is used, then it will display that color. If Background Color 
option is not supplied, then no effect will be noticed. 


Note that when the plot via color pad is selected, one of the eight color 
select keys will select one of the eight plot blocks. The plot option 2 is installed 


See Escape B section for details. 


Code 24 Transmit - 


(Control X) 


Whenever control X is received the terminal starts transmission 
from the visible cursor present position to the end of the screen, or 
until it detects a FF, @%Y Hex sequence in the Refresh memory. 


The transmission sequence is terminated by a carriage return, 
either YD Hex or 8D Hex at the customer option. It should be noted that 
there may be many YD Hex or 8D Hex imbedded in the data transmission 
since these are legal words in the refresh memory. 
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The transmission sends each 8 bit word in memory in 
sequence. That sequence is the ASCII character, then the status of that 
character, followed by the next ASCII character and then its status until 
the FF, @@ sequence is detected. 


The best way to have this data sent back to the terminal 
is via the ESC _] or block receive mode. 


Code 25 Cursor Right - (Control Y) 
Moves the cursor right one character without destroying 
any information. 
Code 26 Cursor Left - (Control 2) 


Moves the cursor left one character without destroying 
any information. 


Code 27 Escape —- (Control [) 


The Escape command effectively expands the control code 
set by 32 additional code capabilities. This requires at least a two 
code sequence (ESC, letter) which then performs a given function. At 
present only 26 of the 32 additional command capabilities have been 
enabled. These commands are given in the following table. (For Detail see 
the Escape Code Section). 


SEE ESCAPE CODE TABLE - Page 17 
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ESCAPE CODE TABLE 


DECIMAL 
OPTIONS CODE LETTER FUNCTION 
) @ Visible Cursor Operation 
a A Blind Cursor Operation 
* 2 B Plot Via Color Pad 
3 @ Transmit Cursor X,Y Position 
4 D Not Used 
* 5 E Re-Entry Control to BASIC 8001 system 
6 F Sets Unit to Full Duplex 
7 G Not Used 
8 H Sets Unit to Half Duplex 
9 £ Not Used 
10 J Sets Unit to Write Vertical 
* 11 K Sets Unit to Roll up Mode & write Left to Right 
12 L Sets Unit to Local Mode 
13 M Not Used 
14 N Not Used 
15 O Re-Entry control to the CPU Operating System 
16 P Initializing & Transfers Control to the CPU 
Operating System 
3 17 Q Allows Operation in Character Insert Mode 
18 R Allows Selection of 1 of 7 Baud Rates 
Es 19 S Transfers Control to the 8080 Assembler 
20 alk Transfers Control to the Text Editor 
- 21 U Inserts one line (80 blanks) 
22 Vv Deletes one line (80 blanks) 
bs 23 W Transfers Control to BASIC 8001 Software 
24 X Sets Unit to Write Left to Right & Page Mode 
25 Y Test Mode-Fills Screen with Next Character 
26 Z Sets Unit to Write Down on 45 Degrees 
27 (. (esc) Not Used 
28 “N Sets Unit to Write Up on 45 Degrees 
29 Ty Sets Unit to Block Receive Mode 
30 JIN Causes a Jump to Ram Address 9FAQH 
31 —_ Transfers Control to the CRT Mode 
The letters are presented for easy reference; i.e., (full 


duplex mode requires ESC, F sequence). It should be noted that the Escape 
control codes can be any 8 bit value so long as the 5 least significant 

bits are correct for the operation desired. The terminal simply masks off 
the undesired higher order bits. The Keyboard and RS232C input port has 
separate and independent Flags which determine some of the CRT modes. 
Therefore, the Keyboard may be in the character input mode while the RS232 
input may be in the Plot mode or vise versa. The input port and the Keyboard 


can operate completely independently of each other. See Details of Escape Codes 
section for more information. 
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Code 28 Cursor Up - (Control \ ) 


Moves the cursor up one line without destroying any 
information. This is effectively the opposite of a Line Feed operation. 


Code 29 Flag Off - (Control) 


When this code is received the Reverse Field flag is 
set to "0". Effects the special character codes (96 to 127) and the 
color codes (16 to 23). 


Code 30 Flag On - (ControlA) 


When this code is received the Reverse Field flag is 
set to one. Effects the special character codes (96 to 127) ; the color 
codes (16 to 23); and the plot modes. 


Code 31 Blink On = (Control _ i} 


When this code is received the Blink bit A, of the 
composite status is set toa "1". 


This bit is turned off when the Blink-Protect-Off key 
is operated (see Code 15 ). 


Code 32 to 95 -— Numbers and Letters 


These provide the standard printing ASCII Upper Case 
characters, punctuations and numbers. See Appendix A-2 for code set of the 
the Intecolor® goo1. 


Code 96 to 127 - Special Characters 


These codes provide either 32 special characters (such as 
lower case ASCII characters) or 64 special characters. The 64 special characters 
are actually two groups of 32 special characters. A group is selected depending 
upon the condition of the Flag bit. If the flag bit is off then the codes are not 
changed when they are placed in the CRT refresh RAM. If the flag bit is on then 
these codes have 96 subtracted from them before they are replaced in the CRT 
refresh RAM. Therefore they are mapped into O to 31 within the CRT refresh memory. 
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DETAILS OF ESCAPE CODES 


@ or Code 0 - Visible Cursor Mode 


This is the terminal's normal mode of operation and 
it is also the startup state. A received character is placed at the visible cursor 
location. The cursor then advances to the right one position awaiting the 
next character. All normal cursor operations are applicable to placing 
the cursor at a different location. 


A or Code 1 - Blind Cursor Mode 


This optional mode provides for a dual cursor operation. 
That is, normally the host computer will operate in the blind cursor 
mode and the keyboard in the visible cursor mode. The two modes will 
not interact with each other. There is also a blind status which may be 
different than the visible status. The only blind cursor movements allowed are 
a subset of the cursor X-Y positioning. See Code 3 or control C. fThis mode 
allows operation without delay for ASCII TEXT at rates up to 38.4 K Baud. 


B or Code 2 - Character Plot Via Color Pad 


When the plot option is installed then this plot mode 
will be available. It will normally be used via the color pad, but can 
be used without it. It provides a mix between the Plot Mode and the normal 
ASCII Character Mode. Instead of responding as described in 
Character Plot, this mode uses only eight codes to intensify each of the 
eight blocks within a character. These intensifying codes are the normal 
color select codes (Control P through W). 


This option normally uses the color select pad on the keyboard. 
The pad is arranged as shown below. 


Yellow 


Color Selection One 
Pad Character Plot 
Aray 


One Plot Block Selected by Green 


Figure 2.5.6.1 
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From the above it is easy to see the one to one 
correspondence between the 2x4 color select pad and the 2x4 character 
plot blocks. Thus, this mode is designed especially for use by the 
keyboard to simplify the drawing of graphs or the correcting of graphs. 
Once in this mode a block at the top right hand corner of the cursor 
present position can be intensified by pushing the top right hand corner 
key in the color select pad, (in this case the blue key or Control T or 
Code 20). Once that plot block has been intensified, any other plot 
block at that same character location can also be intensified since the 
cursor does not automatically advance. If the blue key was to be pushed 
the second time, then the already intensified plot block will be 
extinguished. This effectively allows any one plot block to be erased. 
After all desired plot blocks have been either intensified or extinguished, 
the cursor may be conventionally moved without escaping from this 
special text and character plot mode. In fact, all of the control codes 
are effective while in this mode except the color select control codes, 
and any of the ASCII Text characters can be entered and displayed. Any 
code that requires a two key or more sequence (such as cursor X-Y, CCI, 
and ESC) will terminate the mode. It should be noted that the ASCII 
Character when entered and displayed advances the cursor as previously 
done in the visible mode, but the plot blocks (generated by the color 
pad) do not advance the cursor. Therefore, when a character position has 
been used to display plot blocks a cursor command must be given to 
advance the cursor to the next character position. 


C or Code 3 - Transmit Cursor X,Y 


When this code is selected the terminal sends out the 
following 7 word sequence: 


03, X, Y, O06, Status, ASCII Character, CR. 


The X and Y values represents the cursor position on the screen. The 
status is the status of the ASCII character at that cursor location. The 
CR may be either a ZD or an 8D HEX at the customer request. 


This sequence of transmission is the same that the light pen 
would provide if the unit is so equipped. 


E or Code 5 - Re-Entry to BASIC 8001 


Return to BASIC 8001 without destroying the BASIC 8001 
source program whitch is in Ram memory. 


F or Code 6 —- Full Duplex Mode 


When this mode is selected then the Keyboard characters 
are only sent to the RS232C serial port. They are not processed by the 
terminal. Therefore, once the unit is put in the full duplex mode via 
the keyboard, then the only "normal" way the mode can be changed to 
local or half duplex is via the RS232C serial port. There are two other 
ways that have been provided to regain local control. One way is to 
operate the CPU Reset key on the Keyboard, which will initialize the 
terminal as if power has been just turned on. The other way is to 
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operate the break key on the keyboard. When this is done a break of 150 MS 
will be transmitted on the RS232C serial port, and the terminal will be 
forced into the half duplex mode. 


H or Code 8 - Half Duplex Mode 


When this mode is selected then the keyboard 
characters are not only processed by the terminal but are also sent to the 
RS232C serial port. 


J or Code 10 - Write Vertical Mode 


This effects the visible cursor mode only and causes 
the terminal to enter characters vertically one below the other. All 
other cursor movements are possible via the cursor mode. After a character 
is entered the cursor is moved down one character awaiting the next 
character. Upon reaching the last line the next character will be on 
the top line, i.e. wrap around occurs. 


K or Code 11 - Roll Mode (option 15) Write left to right 


When this mode is selected the terminal will cause a page roll 
up when the last line has been filled. A1148 line units roll two lines at a time 
while 25 line units roll only one line. Note the plot mode and blind cursor mode 
only work in non-roll mode. This mode also sets the visible cursor to write left to 
right. 
Lor Code 12 - local Mode 


When this mode is selected then the keyboard characters 
are displayed on the terminal, but they are not sent tothe RS232C serial 
port. In this mode the RS232C serial input port can receive data or change 
this mode. The terminal can be made to transmit out of the RS232C port, 
while in the local modeby typing Control X or ESC C. 


O or Code 15 - Re-Entry to CPU Operating System Mode 


Causes the same result as Code 16 below but does not 
reinitialize the I/O Byte or the second RS232C channel Baud rate. 


P or Code 16 - Initialize CPU Operating System Mode 


When this optional mode is selected the terminal enters 
into the CPU Operating System. It then obeys all the commands that 
are allowed in the CPU Operating System. See the CPU Operating System Manual. 


Q or Code 17 - Character Insert Mode 


Once in this mode the CRT acts exactly like the normal 
visible cursor system for all control commands except for those requiring 
a 2 or more character sequence (Such as Cursor XY, CCI, and ESC). 
When any character is typed or received via the RS232C input, it is inserted 
within the line at the cursor present position and every character 
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after the cursor to the end of the line is shifted right one character 
position. The last character on the line is lost forever. The cursor 

is also advanced one position. The above is trweexcept for control codes, 
and "Delete" or (shift '__') keys (code 127). 


When the "delete" key is depressed or code 127 is 
received via the RS232 input port then the character at the cursor present 
position is deleted and all characters to the end of the line are 
shifted left one character position. The last character on the line 
becomes a space. The cursor does not advance. 


When the "ESC" key is depressed then the character 
insert-delete mode is terminated after the second character is selected. The 
terminal then normally returns to the visible character mode. 


Ror Code 18 - Baud Rate Selection Mode 


When this mode is entered the unit then accepts the 
next character as one of seven baud rates. It does this by looking at 
only the first three bits. Therefore, any 8 bit character that has the 
desired 3 lower order bits will do. Normally the keyboard numbers 1 to 
7 are used. The baud rates and the corresponding numbers are indicated in 
the table below: 


Normal Baud | 110 ee 1200 | 2400 


High Speed 1200 2400 9600 ; 38,400 |76,800 
Baud Rate 


The unit is initialized with power up at normally 9600 
baud, with one stop bit. This initialized baud rate can be specified by 
the customer at any of the fourteen above rates when ordered. It 
should be noted that only in certain modes (blind cursor mode) can the 
38,400 Baud be used with delays. In no case can 76,800 Baud be used 
without delays. The unit may be ordered with either normal baud rates 
or with the High Speed Baud rates. The two different rate systems cannot 
be mixed. 


The number of stop bits will be determined when the baud rate 
is set by the condition of the A7 flag. If A7 was on before the rate is selected, 
1 stop bit is selected; if A7 was off before the rate is selected 2 stop bits 
are selected. 


S or Code 19 - 8080 Assembler Mode 
When this optional mode is selected the terminal enters 
into the 8080 Assembler Mode. It then obeys all the commands that are 


allowed in the 8080 Assembler. At present this option is not available. 
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T or Code 20 - Text Editor Mode 


When this optional mode is selected the terminal enters 
into the Text Editor Mode. It then obeys all the commands that are 
allowed in the Text Editor. At present this option is not available. 


U or Code 21 - Insert Line Mode 


When this mode is selected the cursor moves to the 
beginning of the line it is presently on and this line and all lines to 
the end of the page is shifted down by one line. Then a new line 
of 80 spaces ( or blanks) are inserted with the cursor 
remaining at the beginning of that new line. 


Normally the cursor will be at the beginning of the 
line to be inserted when this mode is used. After a line has been inserted 
the terminal returns to the normal visible character mode. 


V or Code 22 - Delete Line Mode 


When this mode is selected the cursor moves to the 
beginning of the line it is presently on and this line is deleted. All 
lines to the end of the page are shifted up by one line. Then a new 
line of 80 spaces ( or blanks) are inserted at the bottom of the page. 

The cursor will remain at the beginning of the line that had been deleted. 
After a line has been deleted the terminal returns to the normal visible 
character mode. 


W or Code 23 - BASIC 8001 Language Mode 


When this optional mode is selected the terminal enters 
into the BASIC 8001 Language mode. It then obeys all the commands that 
are allowed in Basic 8001. See the "BASIC 8001 Manual". 


X or Code 24 - Page Mode Write Left to Right 


When this mode is selected the terminal will not roll 
up when the last line has been filled, but will begin at home again. The 
terminal is also placed in the write left to right mode. This is the 
normal power up mode. This mode affects all modes that use the visible 
cursor. The blind cursor and plot modes will only operate in the page mode. 


Y or Code 25 - TEST Mode 
When this mode is selected the next character that follows 


causes the complete screen to be filled with that character. Note use ESC, 
Y, . for a convergence test pattern. 
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Zor Code 26 = Write Down 45 Mode 


When this mode is selected the terminal will place 
the character at the present visible cursor and will then cause a cursor 
right followed by a line feed to occur. Therefore, the next character 
entered will be to the right and down one position from the previous 
character. When the bottom of the page is reached the next character 
will appear on the top of the screen, i.e., wrap around occurs. 


C or ESC or Code 27 - No Effect Code 


Performs a return to visible character mode. 


\ or Code 28 - Write Up 45 Mode 


When this mode is selected the terminal will place the 
character at the present visible cursor and will then cause a cursor right 
followed by a cursor up to occur. Therefore, the next character entered 
will be to the right and up one position from the previous characters. 
When the top of the page is reached the next character will appear on 
the bottom of the screen, i.e., wrap around occurs. 


i or Code 29 - Block Receive Mode 


Causes the unit to enter into the block receive mode. 
Uses the blind cursor to position the data. Looks for a (FF), (00) 
HEX sequence to terminate back to the visible cursor mode. Note this 
is same format as when control (x) or page transmit is requested. Note 
page transmit starts at visible cursor and ends at end of page or when 
an (FF), (00) HEX sequence is found. 


/\ or Code 30 - Jump to RAM 9FA@H 
When this code is received the CRT O.S. branches to 
location 9FAZH. Therefore, the user must patch into RAM address 9FAQH 
a jump to his program. 
— or Code 31 - Transfers Control to the CRT Operating System 
When this code is received, the unit is forced to the 
CRT O.S. mode. If Option 34, the CPU O.S., is also installed, then a 
message will be printed saying: 


YOU ARE NOW IN THE 8001 CRT MODE 
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DETAIL OF GRAPHIC PLOT SUBMODES 


Code 2 Graphic Plot Mode - (Control B) -—- (Option 02) 


The general Graphic Plot Mode is entered by a 
binary code 2 or a Control Code B. (See Appendix B). It should be 
noted that the XY Plot Mode is also entered at the same time. If a 
plot mode other than XY Point Plot is desired, the next word that follows 
should then be a binary code from 240 to 255. These codes represent 
the various plot submodes as shown in the summary of Graphic Plot Submodes. 


An additional feature is available to allow a graphic plot to 
be erased by simply setting the Flag bit on before entering the plot mode. 
This causes an XOR function to exist when plotting. Therefore, if you 
plot the same point, bar or vector twice, the second time erases the 
original. 


Once in the general Plot Mode,: any of the plot submodes 
may be entered by sending the corresponding code to the terminal. When 
this code is received, a flag internal to the terminal, known as PLOFL, 
is set placing the terminal in the appropriate plot submode. It should 
be noted that in many of the plot submodes, PLOFL is automatically set to 
a different value upon completion of the operation of that submode causing 
the terminal to enter a new submode. This is done to make coding and 
operation of the terminal in the various plot functions easier for the 
operator. The various submodes and their interactions are explained in 
detail in Appendix B. 


In addition to being able to enter the plot submodes 


from the general Plot Mode, any plot submode may be entered from any other 
plot submode with the exception of the Character Plot Mode. 
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Colors may be defined on a character by character basis only 
and the color of an individual plot block as well as all other intensified 
plot blocks within a character will be the most recent color defined when 
a new block is intensified in that character. To change a color, it is 
required that the Plot Mode or plot submode be terminated, the color 
changed, and the Plot Mode be re-entered. 


The character grid is made up of 80 characters wide by 25 [4s] 
lines high. The O reference point for all plotting is always the lower 
left corner. Each character is further broken up into 2 blocks wide 
by 4 blocks high which then causes the plot grid to be 160 blocks 
wide by 100 [192] blocks high. All plot submodes operate on this size grid 
and have the same reference point. Positive direction is considered up 
and to the right and negative direction is considered down and to the left. 


All plot submodes and the general Plot Mode are terminated 
or exited by the binary code, 255. Whenever this code is received, 
the modes are terminated and must be re-entered as described above. 


Appendix B-2 gives a convenient summary of the codes 
required to enter the Plot Mode and the various plot submodes as well as 
the status of PLOFL before and after each operation and the ranges of each 
operation. 


Plot Mode - Escape —- (255 binary) 


This code is used to exit from the Plot Mode or any 
of the plot submodes. The control "?"or F15 is used to escape from 
the Plot Mode from the Keyboard. 


Character Plot - (254 binary) 


The Character Plot is entered by a 254 after the general 
Plot Mode, "2" or Control Code B, is entered. From the Keyboard use 
Control ">" or F14. It may also be entered directly from any of the 
other plot submodes. After entering the Character Plot, the next word 
will be treated as a plot character except for code 255 binary or (FF) 
hexadecimal (i.e. all eight bits are "1l's"). See Appendix B- 


The general Plot Mode and the Character Plot terminate 
upon receipt of a 255 code. The above procedure must be repeated after 
a 255 code terminates the Plot Mode and the plot submodes. 


Other plot submodes may not be entered from the Character 
Plot. To enter other plot submodes, the Character Plot must be terminated, 


the general Plot Mode entered and the plot submode entered with its associated 


code. 
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The procedures for entering and exiting the Character 
Plot are shown below. 


Function Code 
Plot Mode 2 
Character Plot 254 
Plot Character 1 0 ‘to 254 
Plot Character n O to 254 
Plot Escape 2519 


The Character Plot causes the 6 wide by 8 high dot 
matrix to be divided into 8 blocks organized 2 blocks wide by 4 blocks 
high. Each block consists of a sub-dot matrix of 3 dots wide by 2 dots 
high. Each block may be individually intensified by defining the bit 
(one of eight bits) associated with the block in the plot character. 
Bits may by "ORed" together for a combination of blocks in a plot character, 
creating a form of graphics for plotting data or drawing diagrams. 
Large characters may also be created by utilizing the blocks of several 
character positions to create a large 5x7 dot matrix. 


X Point Plot - (binary 253) 


The X Point Plot is automatically entered upon receipt 
of the general Plot Mode code, binary code 2, or Control Code B. It 
also may be entered directly from any of the other plot submodes except 
Character Plot. From the Keyboard use Control "=" or F13. After 
entering the X Point Plot, the next word defines the X value 
of the block that is desired to be plotted See Appendix B- 
The X value in this mode may range from binary 0 to 159 and all other 
values will cause 160 to be subtracted and the resultant value of X to 
be computed. 


The X Point Plot may be terminated by code 255 which 
causes the general Plot Mode to be terminated also. Any of the other plo 
submodes may be entered directly from the X Point Plot by simply entering 
the appropriate plot submode codes which range from binary 240 to 254. 


It should be noted that this mode does not cause a 
block to be intensified, but only causes the X value to be defined. Once 
the X value is sent, the terminal is automatically placed in the Y Point 
Plot mode. Thus, the next code sent will be the Y value, which may range 
from binary 0 to 99 [o-191). Upon receipt of the Y value, a plot block 
will be intensified on the CRT screen at the X value and Y value intersection. 
The terminal is then automatically placed in the X Point Plot mode and the 
next word sent will be interpreted as an X value. 


Therefore, once in the X Point Plot mode, new 
blocks may be defined by simply sending X values and Y values consecutively, 


without the necessity of re-entering the X or the Y Point Plot modes. 
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The procedures for entering and exiting the X Point Plot mode are shown 
below: 


Function Code 
Plot Mode* 2 
Xy Value Q to. 159 
Y, Value 0 to 99 (0-191) 
Re Value O to 159 
5 Value O to 99 (0-191) 
Plot Escape 255 
or or 
Plot Submode 240 to 254 


* Automatically X Point Plot mode also 


NOTE: SEND Code 253 between X,Y data sets if necessary 
for timing considerations. See Appendix A-4 for delays. 


The X Point Plot in conjunction with the Y Point Plot 
allows any block on a 160 wide by 100 (192 for 48 Line) high block 
matrix to be positioned to and intensified. If the new block is within 
a character position that is a previously intensified ASCII character, then 
the ASCII character is replaced completely by the new block and its 
associated color. 


Y Point Plot - (binary 252) 


The Y Point Plot is entered by a binary 252 code 
after the general Plot Mode is entered. See Appendix B- 
From the Keyboard use Control "" or F12. It may also be entered 
directly from any of the other plot submodes except Character Plot 
(binary 254). It is more commonly entered automatically from the xX 
Point Plot mode. After entering the Y Point Plot, the next word defines 
the Y value of the block that is desired to be plotted and causes the 
block to be intensified in accordance with the Section on (binary 253). The Y 
value in this mode may range from binary 0 to 99 (0-191) and all larger 
values will cause 100 (192) to be subtracted from the new value of Y to 
be calculated. 


Upon receipt of the Y value, the X Point Plot is 
automatically entered by the terminal. The X value of the next block to 
be plotted may then be sent as explained in the Section on (binary 253). 


The Y Point Plot is terminated by Code 255 which causes 
the general Plot Mode to be terminated also. Any of the other plot submodes 
may be entered directly from the Y Point Plot by simply entering the appropriate 
plot submode codes which range from binary 240 to 254. 
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Therefore, once in the Y Point Plot mode, new points 
may be defined by simply sending X values and Y values consecutively 
without the necessity of re-entering the X or the Y Point Plot modes. The 
procedures for entering and exiting the Y Point Plot mode are shown below: 


Function Code 
Plot Mode 2 
Plot Submode 252 
Yy Value* O to 99 
X5 Value O to 159 
Y>5 Value O to 99 
X, Value 0 to 159 
Yn Value O to 99 
Plot Excape 255 

or or 
Plot Submode 240 to 254 


* Plots point using whatever previous X 
Value left in memory. 


NOTE: Send Code 253 between X,Y data sets if necessary for 
timing considerations. See Appendix A-4 for Delays. 


XY Incremental Point Plot - (binary 251.) 


The XY Incremental Point Plot is entered by code 251 
after the general Plot Mode is entered. From the Keyboard use Control 
";" or Fll. It may also be entered directly from any of the other plot 
submodes, except Character Plot. After entering the XY Incremental Point 
Plot mode, the next word defines the next two increments as shown in 
Figure below. This word may have a range ‘from binary 0 to 239 since binary 
240 to 255 is used for the plot submode codes. 
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n+l an 

0 ) No Change 

il ) Positive Increment 
0 1 Negative Increment 
1 1 No Change 


aie b. through b3 are "O"s, then the plot block will 
not print but will increment one increment according to the coding of 
by, through b7. This allows the user to easily "skip" a plot increment 
by plotting with an invisible block. 


It should be noted that the XY Incremental Plot mode 
does not automatically transfer the terminal to any other plot submode 
upon receipt of an incremental change word,but remains in the XY 
Incremental Plot mode ready to receive another incremental change word. 
Therefore, a series of incremental movements may be made by sending 
consecutive incremental change words. 


The XY Incremental Plot mode may be terminated by code 
255 which causes the general Plot Mode to be terminated also. Any of the 
other plot submodes may be.entered directly from the XY Incremental Point Plot 
by simply entering the appropriate plot submode codes which range from binary 240 
to 254. 


The procedures for entering and exiting the XY 
Incremental plot mode are shown below: 


Function Code 

Plot Mode 2 

or or 

Plot Submode 240 to 253 
XY Incremental 

Point Plot 251 
Incremental Change 

Word 1 0 to 239 


Incremental Change 


Word n 0 ta 239 
Plot Escape 255 

or or 
Plot Submode 240 to 254 


NOTE: Send code 251 between XY incremental point words 
if necessary for timing considerations. See Appendix A-4 for Delays. 
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X Bar Graph, X Value = (binary 250) 
The X Bar Graph, Xe Value is entered by a binary 250 
code after the general Plot mode is entered. From the Keyboard use 
Control ":" or F100. It may also be entered from any of the other plot 
submodes except Character Plot. After entering the X Bar Graph, Bs Value 
Mode, the next word sent defines the X, Value or the left horizontal 
start block of the horizontal bar graph. The graph grid is referenced 
to the lower left hand corner of the face of the CRT. The X, may range 
in value from 0 to 159 and all other values have 160 subtracted and the 
new value calculated for X). 


Upon receipt of the X_ Value, the value of Xe is 
stored in memory and the terminal is automatically placed in the xX 
Bar Graph, Y Value mode (binary 249). The terminal is now ready to 
receive the next eight bit word as the Y position of the bar graph. 
Upon receipt of the Y value, the terminal is then automatically placed 
in the X Bar Graph, X Max Value mode (binary 248). The terminal is 
now ready to receive the next eight bit word as the X Max Value. 
Upon receipt of the X Max Value, the bar is drawn on the CRT and the 
terminal is placed back into the X Bar Graph, Y Value mode (binary 251) 
ready to receive a new Y value to begin the bar graph drawing process 
over again as outlined above. This process is shown below and in 


Appendix B. 
Function Code 
Plot Mode 2 
or or 

Plot Submode 240 to 253 
X Bar Graph, a Value 250 
Xo Value Word 1 0 to 159 
Y Value Word 1 0 to 99 (0-191) 
X Max Value Word 1 0 to 159 
Y Value Word 2 0 to 99 (0-191) 
X Max Value Word 2 O to 159 
Y Value Word n O to 99 (191) 
X Max Word n O to 159 
Plot Escape 255 

or or 
Plot Submode 240 to 254 


NOTE: Use Code 25] between Y value, X max Value data sets 
for timing considerations. Timing delays depends directly upon the 
length of the bar being intensified. SeeAppendix A-4 for delays both 
minimum and maximum. 


As can be seen from the above process, once in the 
X Bar Graph, X, mode, it is necessary to send only two words, Y and X 
Max, to completely define other bar graphs with the same X, in the 
horizontal direction. As before, any of the submodes can be entered 
independently. After the first bar graph sequence, additional bar graphs 
can be described by a new Y position for the graph and a new X Max 
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Value for the graph. The bar is drawn after the X Max Value is received 
using the original value of Xo: 


Any of the other plot submodes may be entered directly 
from the X Bar Graph, entering the appropriate plot submode codes which 
range from binary 240 to 254. 


This mode allows bar graphs in any color or multiple 
colors to be drawn with a width as small as one plot block wide or 
areas under curves may be easily filled in. 


X Bar Graph, Y Value - (binary 249) 


The X Bar Graph, Y Value is entered by a binary 249 
code after the general Plot Mode is entered. From the Keyboard use 
Control "9" or F9. It is more commonly entered from the X Bar Graph, 
25 Value automatically, and may also be entered from any of the other 
plot submodes except Character Plot (binary 254). After entering 
the X Bar Graph, Y Value mode, the next word sent defines the Y 
or vertical position of the horizontal bar graph being drawn. The 
Y value may range from binary 0 to 99 (0 to 191) and all other values 
will have 100 (192) subtracted from it and the new value calculated for 
the Y value. 


Upon receipt of the Y value word, the value of Y is 
stored in memory and the terminal is automatically placed in the X Bar 
Graph, X Max Value mode, as explained more completely in the Section on 
(binary 248). 

Any of the other plot submodes may be entered directly 
from the X Bar Graph, Y Value mode by simply entering the appropriate 
plot submode codes which range from binary 240 to 254. 


X Bar Graph, X Max Value - (binary 248) 


The X Bar Graph, X Max Value is entered by a binary 
248 code after the general Plot Mode is entered. From the Keyboard use 
Control "8" or F8. It is more commonly entered from the X Bar Graph, Y 
Value automatically, and may also be entered from any of the other plot 
submodes except Character Plot. After entering the X Bar Graph, X Max 
Value mode, the next word received defines the X Max horizontal point of 
the horizontal bar graph being drawn. The X Max Value may range from 
0 to 159 and all other values will have 160 subtracted from it and the 
new value calculated for X Max Value. 


Upon receipt of the X Max Value word, the bar graph 
is drawn in the predefined color on the face of the CRT according to the 
X, and Y value stored in memory from previous operations. The terminal 
is then automatically placed in the X Bar Graph, Y Value mode, binary 249, 
for the beginning of a new bar graph as more completely explained in the 
Section on (binary 248). 


Any of the other plot submodes may be entered directly 
from the X Bar Graph, X Max Value mode by simply entering the appropriate 
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plot submode codes which range from binary 240 to 254. 


X Incremental Bar Graph - (binary 247) 


The X Incremental Bar Graph is entered by a binary 247 
code after the general Plot Mode is entered. From the Keyboard use 
Control "7" or F7. It may also be entered from any of the other plot 
submodes except Character Plot. After entering the X Incremental 
Bar Graph mode, the next word sent defines the next two horizontal and 
vertical increments for two horizontal bar graphs. Thus, one may 
position a bar graph each side of the present location and add or 
subtract an increment to the bar graph previously defined. The coding 


and composition is the same as explained in the Section on (binary 251). An example 
is shown in Appendix B-6. 


¥ Bar Graph, Y, Value - (binary 246) 

The Y Bar Graph, Y, Value is entered by a binary 246 
code after the general Plot Mode is entered. From the Keyboard use 
Control "6" or FO. It may also be entered from any of the other plot 
submodes except Character Plot. After entering the Y Bar Graph, Y, Value 
mode, the next word sent defines the Y, or the vertical start point of the 
vertical bar graph being drawn. The range of the Y_ word is 0 to 99 
(0-191) and all other values have 100 (192) subtracted and will have the 
new value calculated for Y, Value. 


All other operations are identical as explained in the 
Section on (binary 250), X Bar Graph, X9 Value except that Y Bar Graph, X Value 
and Y Bar Graph, Y Max Value are applicable for drawing vertical bar 
graphs. An example is shown in Appendix B-5. 


Y Bar Graph, X Value - (binary 245) 


The Y Bar Graph, X Value is entered by a binary 245 
code after the general Plot Mode is entered. From the Keyboard use 
Control "5" or F5. It is more commonly entered from the Y Bar Graph, 

Y, Value automatically, and may also be entered from any of the other plot 
submodes except Character Plot. After entering the Y Bar Graph, X Value 
mode, the next word sent defines the X, or horizontal position of the 
vertical bar graph being drawn. The X Value may range from 0 to 159 and 
all other values will have 160 subtracted and will have the new value 
calculated for the X value. 


All other operations are identical as explained inthe 
Section on binary 249, X Bar Graph, Y Value except that Y Bar Graph, Yo Value 


and Y Bar Graph, Max Value are applicable for drawing vertical bar 
graphs. An example is shown in Appendix B-5. : 


Y Bar Graph, Y Max Value - (binary 244) 
The Y Bar Graph, Y Max Value is entered by a binary 


244 code after the general Plot Mode is entered. From the Keyboard use 
Control "4" or F4. It is more commonly entered from the Y Bar Graph, X 
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Value automatically, and also may be entered from any of the other 

plot submodes except Character Plot. After entering the Y Bar Graph, 

Y Max Value mode, the next word received defines the vertical Y Max point 
of the vertical bar graph being drawn. The Y Max Value may range from 
binary 0 to 99 (0-191) and all other values will have 100 (192) 
subtracted and will have the new value calculated for Y Max Value. 


All other operations are identical as explained inthe 
Section on (binary 248), X Bar Graph, X Value, except that Y Bar Graph, Yo Value 
and Y Bar Graph, X Value are applicable for drawing vertical bar graphs. 
An example is shown in Appendix B-5. 


Y Incremental Bar Graph - (binary 243) 


The Y Incremental Bar Graph is entered by a binary 243 
code after the general Plot Mode is entered. From the Keyboard use Control 
"3" or F3. It may be entered from any of the plot submodes except Character 
Plot. After entering the Y Incremental Bar Graph mode, the next word sent 
defines the next two horizontal and vertical increments for two vertical 
bar graphs. 

All other operations are identical as explained in the 
Section on (binary 247), X Incremental Bar Graph except for the mode being 


applicable for drawing vertical bar graphs. An example is shown in Appendix 
B-6. 


Vector Mode X,Value - (binary 242) 


The Vector Mode is entered by a binary 242 code after 
the general Plot Mode is entered. From the Keyboard use Control "2" 
or F2. It may be entered from any of the plot submodes except Character Plot. 
After entering the Vector Mode, X, Value, the next word defines the x5 
Value point of the vector being drawn. 


The Vector Mode requires the two end points to be 
defined (i.e. Ko Yo and +) Ya)> The x ,Y, values should previously be 
defined by way of the X,Y Point Plot Mode. 


Upon receipt of the X, Value the terminal is automatically 
placed in the Vector Me Value Mode (binary 241). The terminal is now ready 
to receive the next eight bit word as the Y, Vector Value. Upon receipt 
of the Y, Value the terminal then determines the best straight line fit between 
Xo Yo and Xj), Yy using the plot blocks. The terminal will then revert to 
the Vector Mode X, value (binary 242), ready to receive the new X, Value 
for another vector. The process is shown below and in Appendix B-7. 
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Function Code 


Plot Mode 2 
or 
X point Plot submode 253 
Xi Vector point 1 0 to 154 
Y, Vector point 1 0 to 99 191) 
Xo Vector plot submode 242 
Xo Vector point 1 0 ‘to- 159 
Yo Vector point 1 0 to 99 (191) 
XQ Vector point N-1l O to 159 
Yo Vector point N-1 0 to 99 (191) 
Xo Vector point N 0 to 159 
Yo Vector point N 0 to 99 (191) 
Plot Escape 255 
or 
Plot Submode 240 to 254 


NOTE: Send code 242 between Yo vector point and X%, vector point 
words if necessary for timing considerations. See Appendix A-4 for 
delays. 


Vector Mode Y. Value - (binary 241) 


The Y, vector is entered by binary 241 code after the 
general Plot Mode is entered. From the keyboard use Control "1" 
or FL, This mode is more commonly entered automatically from 
the X, Vector mode. After entering the Y, Vector mode, the next word 
defines the ¥, value of the vector being drawn. There is no Yestriction on 
Yg with respect to Y, except it must be in the range of 0 to 99 Gee Upon 
receipt of the a9 value a vector is drawn from X], eo Xor Ye with 
the new X)¥) now at the old X,Y¥,. If the next vector has a Xj ¥Y ] value = 
XoY, Old, then only the new XoYo need be sent. This would effectively draw 
a vector from the present Xg Yo position to the new X,Y, point. See 
Appendix B-7. 


Xo Yo - Incremental Vector Mode - (binary 240) 


£he AH vs incremental vector mode is entered by a binary 
240 code after the general plot mode is entered. From the keyboard use control 
"O" or FZ. It may also be entered from any of the other plot submodes 
except Character Plot. After entering the incremental vector mode, the next 
word sent defines the increments in Xo, Yo, Xz, and Yy point values for the 
vector from X,Y, to X,Y,. This word may have a range from binary 0 to 239 
Since binary 240 to 255 are used for the plot submode codes. 


Referring to the section on (binary 251), XY Incremental Point Plot 
it can be seen that there is one two bit element available for each of the 
4 points (1.6. Xo, Yo. %y and Ya ). ThedxX r,AY, refers to the increment in 


Xj, Y¥ , of the vector and the 4X2, AY2 refers to the increment in Xg, Y, of the 


fo) 
vector. 
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Therefore, if bg and bs are both 1 or both @ then no 
increment will take place. If either half of the word is all zero then the 
corresponding X,Y will be changed but no vector will be drawn. This allows 
the user to eaSily "skip" points. The only time a vector will be drawn is 
when both halfs of the word are non zero. 


The incremental vector plot mode does not automatically 
transfer control to any other mode. It remains in this incremental mode until 
terminated by a plot submode code. Therefore a series of incremental 
movements in both X,, Yoand X1Yjmay be made by sending consecutive incremental 
change words. 


The procedure for entering and exiting the XY Incremental plot 
mode are shown below: 


Function Code 
Plot Mode 2 
or or 
Plot Submode 240 ‘to 253 
Incremental Vector 240 
Plot Mode 


Incremental change 


in X1, Yq, Xor Yo 
Word 1 O “bo 239 
Word N O to 239 
Plot. Escape 255 
or or 
Plot Submode 240 to 254 


NOTE: Send code 240 between incremental vector words if 
necessary for timing considerations. See Appendix A-4 for input 
Delay Times. 
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LIGHT PEN OPERATION (Option 28) 


The Intecolor 8001 Light Pen is designed to move the cursor on 
the screen of the terminal by simply pointing to the desired location on the 
screen and touching with the forefinger the touch-sensitive end of the light 
pen. The touch sensitive end of the light pen acts as a switch or button. 


To effect operation of the light pen, the pen is simply pointed to 
the desired location on the screen. Either the standard lense or the long range 
lense may be used in the same manner. When the desired location is reached, 
the forefinger is placed on the touch-sensitive end of the pen and held 
on the pen until the cursor on the screen resides at the location the pen 
is pointing to. As long as the finger is kept on the pen the cursor will 
follow the pen to any location. 


When the cursor is at the desired location, lift the forefinger from the 
tip of the pen and the following 7 word sequence will be transmitted to the Jl 
RS232 output port. 


03 Cursor X-Y (See Code 3) 

xX X Cursor Coordinate 

Y Y Cursor Coordinate 

06 CCI (See Code 6) 

Status Status Character (See Appendix A-6) 
ASCII or 

Special 

Character 

8D Carriage Return 


Notice that this sequence is not transmitted unless the 
finger first touches the end of the pen in the touch sensitive area and is 
effected when the finger is lifted from the end of the pen. 


Note that a blue flood is normal operation and occurs every 


time the touch sensitive end of the pen is touched by the forefinger and 
will repeat at a 2cps rate until the finger is lifted. 
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Delay Times are in Milliseconds 


Mode 
Blind Cursor 
Character Store 


Most Control 
Codes 
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Character Store 
Left-Right 

2X Char 
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Characters 
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1.1 


TMS 5501 MULTIFUNCTION INPUT/OUTPUT CONTROLLER 


INTRODUCTION 


DESCRIPTION 


The TMS 5501 is a multifunction input/output circuit for use with Tl’s TMS 8080 CPU. It is fabricated with the same 
N-channel silicon-gate process as the TMS 8080 and has compatible timing, signal levels, and power supply 
requirements. The TMS 5501 provides a TMS 8080 microprocessor system with an asynchronous communications 


interface, data !/O buffers, interrupt control logic, and interval timers. 
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FIGURE 1—TMS 5501 BLOCK DIAGRAM 


XMT 


The I/O section of the TMS 5501 contains an eight-bit parallel input port and a separate eight-bit parallel output port 


with storage register. Five programmable interval timers provide time intervals from 64 us to 16.32 ms. 


The interrupt system allows the processor to effectively communicate with the interval timers, external signals, and the 


communications interface by providing TMS 8080-compatible interrupt logic with masking capability. 


Data transfers between the TMS 5501 and the CPU are carried by the data bus and controlled by the interrupt, chip 
enable, sync, and address lines. The TMS 8080 uses four of its memory-address lines to select one of 14 commands to 


which the TMS 5501 will respond. These commands allow the CPU to: 


--- read the receiver buffer 
- read the input port 
---- read the interrupt address 
---- read TMS 5501 status 
---- Issue discrete commands 
- load baud rate register 
- load the transmitter buffer 
---- load the output port 
---- load the mask register 
--- load an interval timer 
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The commands are generated by executing memory referencing instructions such as MOV (register to memory) with the 
memory address being the TMS 5501 command. This provides a high degree of flexibility for 1/O operations.by letting 
the systems programmer use a variety of instructions. 


SUMMARY OF OPERATION 
Addressing the TMS 5501 


A convenient method for addressing the TMS 5501 is to tie the chip enable input to the highest order address line of 
the CPU’s 16-bit address bus and the four TMS 5501 address inputs to the four lowest order bits of the bus. This, of 
course, limits the system to 32,768 words of memory but in many applications the full 65,536 word memory 
addressing capability of the TMS 8080 is not required. 


Communications Functions 


The communications section of the TMS 5501 is an asynchronous transmitter and receiver for serial communications 
and provides the following functions: 


Programmable baud rate — A CPU command selects a baud rate of 110, 150, 300, 1200, 2400, 4800, or 9600 baud. 


Incoming character detection — The receiver detects the start and stop bits of an incoming character and places the 
character in the receive buffer. 


Character transmission — The transmitter generates start and stop bits for a character received from the CPU and 
shifts it out. 


Status and command signals — Via the data bus, the TMS 5501 signals the status of: framing error and overrun error 
flags; data in the receiver and transmitter buffers; start and data bit detectors; and end-of-transmission (break) signals 
from external equipment. It also issues break signals to external equipment. 


Data Interface 


The TMS 5501 moves data between the CPU and external devices through its internal data bus, input port, and output 
port. When data is present on the bus that is to be sent to an external device, a Load Output Port (LOP) command from 
the CPU puts the data on the XO pins of the TMS 5501 by latching it in the output port. The data remains in the port 
until another LOP command is received. When the CPU requires data that is present on the External Input (XI) lines, it 
issues a Command that gates the data onto the internal data bus of the TMS 5501 and consequently onto the CPU’s 
data bus at the correct time during the CPU cycles. 


Interval Timers 


To start a countdown by any of the five interval timers, the program selects the particular timer by an address to the 
TMS 5501 and loads the required interval into the timer via the data bus. Loading the timer activates it and it counts 
down in increments of 64 microseconds. The 8-bit counters provide intervals that vary in duration from 64 to 16,320 
microseconds. Much longer intervals can be generated by cascading the timers through software. When a timer reaches 
zero, it generates an interrupt that typically will be used to point to a subroutine that performs a servicing function 
such as polling a peripheral or scanning a keyboard, Loading an interval value of zero causes an immediate interrupt. A 
new value loaded while the interval timer is counting overrides the previous value and the interval timer starts counting 
down the new interval. When an interval timer reaches zero it remains inactive until a new interval is loaded. 
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Servicing Interrupts 


The TMS 5501 provides a TMS 8080 system with several interrupt control functions by receiving external interrupt 
signals, generating interrupt signals, masking out undersired interrupts, establishing the priority of interrupts, and 
generating RST instructions for the TMS 8080. An external interrupt is received on pin 22, SENS. An additional 
external interrupt can be received on pin 32, X17, if selected by a discrete command from the TMS 8080 (See 
Figure 4). The TMS 5501 generates an interrupt when any of the five interval timers count to zero. Interrupts are also 
generated when the receiver buffer is loaded and when the transmitter buffer is empty. 


When an interrupt signal is received by the interrupt register from a particular source, a corresponding bit is set and 
gated to the mask register. A pattern will have previously been set in the mask register by a load-mask-register command 
from the TMS 8080. This pattern determines which interrupts will pass through to the priority logic. The priority logic 
allows an interrupt to generate an RST instruction to the TMS 8080 only if there is no higher priority interrupt that 
has not been accepted by the TMS 8080. The TMS 5501 prioritizes interrupts in the order shown below: 


1st — Interval Timer =1 

2nd —_ Interval Timer =2 

3rd — External Sensor 

4th — Interval Timer #3 

5th — _ Receiver Buffer Loaded 

6th — Transmitter Buffer Emptied 

7th — Interval Timer #4 

8th — Interval Timer #5 or an External Input (XI 7) 


The highest priority interrupt passes through to the interrupt address logic, which generates the RST instruction to be 
read by the TMS 8080. See Table 3 for relationship of interrupt sources to RST instructions and Figures 6 and 8 for 
timing relationships. 


The TMS 5501 provides two methods of servicing interrupts; an interrupt-driven system or a polled-interrupt system. In 
an interrupt-driven system, the INT signal of the TMS 5501 is tied to the INT input of the TMS 8080. The sequence of 
events will be: (1) The TMS 5501 receives (or generates) an interrupt signal and readies the appropriate RST 
instruction. (2) The TMS 5501 INT output, tied to the TMS 8080 INT input, goes high signaling the TMS 8080 that an 
interrupt has occured. (3) If the TMS 8080 is enabled to accept interrupts, it sets the INTA (interrupt acknowledge) 
status bit high at SYNC time of the next machine cycle. (4) If the TMS 5501 has previously received an interrupt- 
acknowledge-enable command from the CPU (see Bit 3, Paragraph 2.2.5), the RST instruction is transferred to the data 
bus. 


In a polled-interrupt system, INT is not used and the sequence of events will be: (1) The TMS 5501 receives (or 
generates) an interrupt and readies the RST instruction. (2) The TMS 5501 interrupt-pending status bit (see Bit 5, 
Paragraph 2.2.4) is set high (the interrupt-pending status bit and the INT output go high simultaneously). (3) At the 
prescribed time, the TMS 8080 polls the TMS 5501 to see if an interrupt has occurred by issuing a_read- 
TMS 5501-status command and reading the interrupt-pending bit. (4) If the bit is high, the TMS 8080 will then issue a 
read-interrupt-address command, which causes the TMS 5501 to transfer the RST instruction to the data bus as data for 
the instruction being executed by the TMS 8080. 


APPLICATIONS 
Communications Terminals 


The functions of the TMS 5501 make it particularly useful in TMS 8080-based communications terminals and generally 
applicable in systems requiring periodic or random servicing of interrupts, generation of control signals to external 
devices, buffering of data, and transmission and reception of asynchronous serial data. As an example, a system 
configuration such as shown in Figure 2 can function as the controller for a terminal that governs employee entrance 
into a plant or security areas within a plant. Each terminal is identified by a central computer through ID switches. The 
central system supplies each terminal’s RAM with up to 16 employee access categories applicable to that terminal. 
These categories are compared with an employee's badge character when he inserts his badge into the badge sensor. If a 


match is not found, a reject light will be activated. If a match is found, the terminal will transmit the employee’s badge 
number and access category to the central system, and a door unlock solenoid will be activated for 4 seconds. The 
central computer then may take the transmitted information and record it along with time and date of access. 


The TMS 4700 is a 1024 x 8 ROM that contains the system program, and the TMS 4036 is a 64 x 8 RAM that serves as 
the stack for the TMS 8080 and storage for the access category information. TTL circuits control chip-enable information 
carried by the address bus. Signals from the CPU gate the address bits from the ROM, the RAM, or the TMS 5501 onto 
the data bus at the correct time in the CPU cycle. The clock generator consists of four TTL circuits along with a crystal, 
needed to maintain accurate serial data assembly and disassembly with the central computer. 


The TMS 5501 handles the asynchronous serial communication between the TMS 8080 and the central system and 
gates data from the badge reader onto the data bus. It also gates control and status data from the TMS 8080 to the door 
lock and badge reader and controls the time that the door lock remains open. The TMS 5501 signals the TMS 8080 
when the badge reader or the communication lines need service. The functions that the TMS 5501 is to perform are 
selected by an address from the TMS 8080 with the highest order address line tied to the TMS 5501 chip enable input 
and the four lowest order lines tied to the address inputs. 


2. OPERATIONAL AND FUNCTIONAL DESCRIPTION 
This detailed description of the TMS 5501 consists of: 
INTERFACE SIGNALS — a definition of each of the circuit’s external connections 
COMMANDS — the address required to select each of the TMS 5501 commands and a description of the response to 
the command. 
2.1 INTERFACE SIGNALS 
The TMS 5501 communicates with the TMS 8080 via four address lines: a chip enable line, an eight-bit bidirectional 
data bus, an interrupt line, and a sync line. It communicates with system components other than the CPU via eight 
external inputs, eight external outputs, a serial receiver input, a serial transmitter output, and an external sensor input. 
Table 1 defines the TMS 5501 pin assignments and describes the function of each pin. 
TABLE 1 
TMS 5501 PIN ASSIGNMENTS AND FUNCTIONS 
SIGNATURE PIN DESCRIPTION 
INPUTS 
CE 18 Chip enable—When CE is low, the TMS 5501 address decoding is inhibited, which prevents 
execution of any of the TMS 5501 commands. 

A3 17 Address bus—A3 through Aare the lines that are addressed by the TMS 8080 to select a particular 

A2 16 TMS 5501 function. 

Al 15 

AO 14 
SYNC 19 Synchronizing signal—T he SYNC signal is issued by the TMS 8080 and indicates the beginning of a 


machine cycle and availability of machine status. When the SYNC signal is active (high), the 
TMS 5501 will monitor the data bus bits DO (interrupt acknowledge) and D1 (WO, data output 
function). 

RCV 5 Receiver serial data input line-RCV must be held in the inactive (high) state when not receiving 
data. A transition from high to low will activate the receive circuitry. 


SIGNATURE PIN 


X10 
XI 1 
X12 
X13 
X14 
X15 
X16 
X17 


SENS 


x00 
XO 1 
XO 2 
XO 3 
X04 
XO 5 
XO 6 
XO 7 


XMT 


DO 
D1 
D2 
D3 
D4 
D5 
D6 
D7 


INT 


Vss 
VBB 
Vcc 
VDD 
¢1 
$2 


39 
38 
37 
36 
35 
34 
33 
32 


22 


TABLE 1 (continued) 
TMS 5501 PIN ASSIGNMENTS AND FUNCTIONS 


DESCRIPTION 
INPUTS 
External inputs—These eight external inputs are gated to the data bus when the read-external-inputs 
function is addressed. External input n is gated to data bus bit n without conversion. 


External interrupt sensing — A transition from low to high at SENS sets a bit in the interrupt 
register, which, if enabled, generates an interrupt to the TMS 8080. 


OUTPUTS 


External outputs—These eight external outputs are driven by the complement of the output 
register; i.e., if output register bit n is loaded with a high (low) from data bus bit n by a load- 
output register command, the external output n will be alow (high). The external outputs change 
only when a load-output-register function is addressed. 


Transmitter serial data output line—This line remains high when the TMS 5501 is not transmitting. 


DATA BUS INPUT/OUTPUT 


Data bus — Data transfers between the TMS 5501 and the TMS 8080 are made via the 8-bit 
bidirectional data bus. DO is the LSB. D7 is the MSB. 


Interrupt—When active (high), the INT output indicates that at least one of the interrupt conditions 
has occurred and that its corresponding mask-register bit is set. 


POWER AND CLOCKS 


Ground reference 

Supply voltage (—5 V nominal) 
Supply voltage (5 V nominal) 
Supply voltage (12 V nominal) 
Phase 1 clock 

Phase 2 clock 
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2.22. TMS 5501 COMMANDS 


The TMS 5501 operates as memory device for the TMS 8080. Functions are initiated via the TMS 8080 address bus and 
the TMS 5501 address inputs. Address decoding to determine the command function being issued is defined in Table 2. 


TABLE 2 
COMMAND ADDRESS DECODING 
When Chip Enable Is High 


A3 A2 Al AO COMMAND FUNCTION PARAGRAPH 
L L L L Read receiver buffer RBn> Dn 2.2.1 
L L L H Read external inputs Xin Dn 2.2.2 
L L H L Read interrupt address RST > Dn 2:23 
L L H H Read TMS 5501 status (Status) > Dn 2.2.4 
L H L L_ Issue discrete commands See Figure 4 2.2.5 
L H L H Load rate register See Figure 4 2.2.6 
L H H L Load transmitter buffer Dn TBn 2.2.7 
LH HH Load output port Dn- XOn 2.2.8 
H L L L_ Load mask register Dn > MRn 2.2.9 
H L L H Load interval timer 1 Dn~ Timer 1 2.2.10 
H L H L Load interval timer 2 Dn~> Timer 2 2.2.10 
H L H H Load interval timer 3 Dn => Timer 3 2.2.10 
H H L L Load interval timer 4 Dn > Timer 4 2.2.10 
H H L H Load interval timer 5 Dn Timer 5 2.2.10 
H H H L. No function 
H H H H_ No function 

RBn Receiver buffer bit n 

Dn Data bus I/O terminal n 

Xin External input terminal n 

RST 11 (Ag) (1A) (1Ag) 11-1 (see Table 3) 

TBn~ Transmit buffer bit n 

XOn Output register bitn 

MRn_~ Mask register bitn 

TABLE 3 


RST INSTRUCTIONS 


DATA BUS BIT INTERRUPT CAUSED BY 


0123 4 5 6 7 

H H H L L L H_ H Interval Timer 1 

H H H H L L H _ H Interval Timer 2 

H H H L H L H H External Sensor 

H H H H H L H H Interval Timer 3 

H H H L LH H H Receiver Buffer 

H H H H L H H_ H Transmitter Buffer 

H H H L H H H _ H Interval Timer 4 

H H H H H H H_ H Interval Timer 5 or X17 
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2.2.1 


2.2.2 


2.2.3 


2.2.4 


The following paragraphs define the functions of the TMS 5501 commands. 


Read receiver buffer 


Addressing the read-receiver-buffer function causes the receiver buffer contents to be transferred to the TMS 8080 and 
clears the receiver-buffer-loaded flag. 


Read external input lines 
Addressing the read-external-inputs function transfers the states of the eight external input lines to the TMS 8080. 


Read interrupt address 


Addressing the read interrupt address function transfers the current highest priority interrupt address onto the data bus 
as read data. After the read operation is completed, the corresponding bit in the interrupt register is reset. 


lf the read-interrupt-address function is addressed when there is no interrupt pending, a false interrupt address will be 
read. TMS 5501 status function should be addressed in order to determine whether or not an interrupt condition is 
pending. 


Read TMS 5501 status 


Addressing the read-TMS 5501-status function gates the various status conditions of the TMS 5501 onto the data bus. 
The status conditions, available as indicated in Figure 3, are described in the following paragraphs. 


BIT: 2 1 0 
SERIAL}OVERRUN | FRAME 
PENDING| BUFFER | BUFFER | RCVD |ERROR ERROR 
DETECT] DETECT 


FIGURE 3—DATA BUS ASSIGNMENTS FOR TMS 5501 STATUS 


Bit 0, framing error 


A high in bit O indicates that a framing error was detected on the last character received (either one or both stop bits 
were in error). The framing error flag is updated at the end of each character. Bit O of the TMS 5501 status will remain 
high until the next valid character is received. 


Bit 1, overrun error 


A high in bit 1 indicates that a new character was loaded into the receiver buffer before a previous character was read 
out. The overrun error flag is cleared each time the read-I/O-status function is addressed or a reset command is issued. 


Bit 2, serial received data 


Bit 2 monitors the receiver serial data input line. This line is provided as a status input for use in detecting a break and 
for test purposes, Bit 2 is normally high when no data is being received. 


Bit 3, receiver buffer loaded 


A high in bit 3 indiciates that the receiver buffer is loaded with a new character. The receiver-buffer-loaded flag remains 
high until the read-receiver-buffer function is addressed (at which time the flag is cleared). The reset function also clears 
this flag. 


Cc-9 


2.2.5 


Bit 4, transmitter butfer empty 

A high in bit 4 indicates that the transmitter buffer register is empty and ready to accept a character. Note, however, 
that the serial transmitter register may be in the process of shifting out a character. The reset function sets the 
transmitter-buffer-empty flag high. 


Bit 5, interrupt pending 
A high in bit 5 indicates that one or more of the interrupt conditions has occured and the corresponding interrupt is 
enabled. This bit is the status of the interrupt signal INT. 


Bit 6, full bit detected 
A high in bit 6 indicates that the first data bit of a receive-data character has been detected. This bit remains high until 
the entire character has been received or until a reset is issued and is provided for test purposes. 


Bit 7, start bit detected 
A high in bit 7 indicates that the start bit of an incoming data character has been detected. This bit remains high until 


the entire character has been received or until a reset is issued and is provided for test purposes. 
Issue discrete commands 
Addressing the discrete command function causes the TMS 5501 to interpret the data bus information according to the 


following descriptions. See Figure 4 for the discrete command format. Bits 1 through 5 are latched until a different 
discrete command is received. 


NORMALLY LOW 


BIT: 2 1 0 
INT. 
ACK. ee BREAK } RESET 
ENABLE 


H: Enables interrupt acknowledge 


H: Reset 
L: Inhibits interrupt acknowledge LL: No action 


H: Selects X| 7 
L: Selects interval timer 5 


H: L Sets XMT output low 
L: H Sets XMT output high 


FIGURE 4—DISCRETE COMMAND FORMAT 
Bit 0, reset 
A high in bit 0 will cause the following: 


1) The receiver buffer and register are cleared to the search mode including the receiver-buffer-loaded flag, the 
start-bit-detected flag, the full-bit-detected flag, and the overrun-error flag. The receiver buffer is not cleared and 
will contain the last character received. 


2) The transmitter data output is set high (marking). The transmitter-buffer-empty flag is set high indicating that the 
transmitter buffer is ready to accept a character from the TMS 8080. 


3) The interrupt register is cleared except for the bit corresponding to the transmitter buffer interrupt, which is set 
high. 


4) The interval timers are inhibited. 


A low in bit O causes no action. The reset function has no affect on the output port, the external inputs, interrupt 
acknowledge enable, the mask register, the rate register, the transmitter register, or the transmitter buffer. 
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Bit 1, break 
A low in bit 1 causes the transmitter data output to be reset low (spacing). 


If bit O and bit 1 are both high, the reset function will override. 


Bit 2, interrupt 7 select 
Interrupt 7 may be generated either by alow to high transition of external input 7 or by interval timer 5. 


A high in bit 2 selects the interrupt 7 source to be the transition of external input 7. A low in bit 2 selects the 
interrupt 7 source to be interval timer 5. 


Bit 3, interrupt acknowledge enable 
The TMS 5501 decodes data bus (CPU status) bit 0 at SYNC of each machine cycle to determine if an interrupt 


acknowledge is being issued. 


A high in bit 3 enables the TMS 5501 to accept the interrupt acknowledge decode. A low in bit 3 causes the TMS 5501 
to ignore the interrupt acknowledge decode. 


Bit 4 and bit 5 are used only during testing of the TMS 5501. For correct system operation both bits must be kept low. 
Bit 6 and bit 7 are not used and can assume any value. 
2.2.6 Load rate register 


Addressing the load-rate-register function causes the TMS 5501 to load the rate register from the data bus and interpret 
the data bits (See Figure 5) as follows. 


BIT: 3 2 1 0 
1200 300 150 110 
baud baud baud baud 


H: One stop bit 
L: Two stop bits 


FIGURE 5—DATA BUS ASSIGNMENTS FOR RATE COMMANDS 
Bits 0 through 6, rate select 


The rate select bits (bits 0 through 6) are mutually exclusive, i.e., only one bit may be high. A high in bits 0 through 6 
will select the baud rate for both the transmitter and receiver circuitry as defined below and in Figure 5: 


Bit O 110 baud 
Bit 1 150 baud 
Bit2 300 baud 
Bit 3. 1200 baud 
Bit 4 2400 baud 
Bit5 4800 baud 
Bit6 9600 baud 


If more than one bit is high, the highest rate indicated will result. If bits 0 through 6 are all low, both the receiver and 
the transmitter circuitry will be inhibited. 


Bit 7, stop bits 
Bit 7 determines whether one or two stop bits are to be used by both the transmitter and receiver circuitry. A high in 
bit 7 selects one stop bit. A low in bit 7 selects two stop bits. 


2.2.7 Load transmitter buffer 


Addressing the load-transmitter-buffer function transfers the state of the data bus into the transmitter buffer. 


2.2.8 Load output port 


Addressing the load-output-port function transfers the state of the data bus into the output port. The data is latched 
and remains on XO O through XO 7 as the complement of the data bus until new data is loaded. 


2.2.9 Load mask register 


Addressing the load-mask-register function loads the contents of the data bus into the mask register. A high in data bus 
bit n enables interrupt n. A low inhibits the corresponding interrupt. 


2.2.10 Load timer n 


3.1 


Addressing the load-timer-n function loads the contents of the data bus into the appropriate interval timer. Time 
intervals of from 64 us (data bus = LLLLLLLH) to 16,320 us (data bus HHHHHHHH) are counted in 64-us, steps. 
When the count of interval timer n reaches O, the bit in the interrupt register that corresponds to timer n is set and 
an interrupt is generated. Loading a!l lows causes an interrupt immediately. 


TMS 5501 ELECTRICAL AND MECHANICAL SPECIFICATIONS 


ABSOLUTE MAXIMUM RATINGS OVER OPERATING FREE-AIR TEMPERATURE RANGE 
(UNLESS OTHERWISE NOTED)* 


Supply voltage, Vcc (see Note 1) Sree ay Tie Pe eas Sas ae a ig Nea eevee as eae Ov a Bea eae Te eee SNA: ZO. 
Supply voltage, Vpp (see Note 1 Sods > fram Gi hed BOS we GAS Sees S104. 24 —OS Vito 20V 
Supply voltage, Vss (see Note 1) Zn Ee DR Sante: woke Wt ba te hi ew Slat oan 2 ave Getia® w abo aan —O.3 V to 20V 
All input and output voltages (see Note 1) . 2...) ee ee ee ee es 670.3 V to 20 V 
Continuous power dissipation: .. . .a-séeeh Aeew oa ec eee es RD coded tt Gate Shem naw oe 17 W 
Operating free-air temperature range... ee ee ee ee ee 60°C to 70°C 
Storage temperature range.) ww ee ee ee e)~»6 65°C to 150°C 


*Stresses beyond those listed under '‘Absolute Maximum Ratings’’ may cause permanent damage to the device. This is a stress rating only 


and functional operation of the device at these or any other conditions beyond those indicated in the ‘‘Recommended Operating 
Conditions” section of this specification is not implied. Exposure to absolute-maximum-rated conditions for extended periods may affect 
device reliability. 


NOTE 1: Under absolute maximum ratings voltage values are with respect to the normally most negative supply voltage, Vag (substrate). 


Throughout the remainder of this data sheet, voltage values are with respect to Vss unless otherwise noted. 


3.2 RECOMMENDED OPERATING CONDITIONS 


MIN NOM MAX [UNIT 
Supply voltage, Vag [-4.75  -5 5.25 


Supply voltage, Vcc 4.75 5 5.25 


Supply voltage, Vp 14 12 126 
Supply voltage, Vss 0 


High-level input voltage, Vj (all inputs except clocks) 


High-level clock input voltage, VjH(@) 


Low-level input voltage, V;__ (all inputs except clocks) (see Note 2) 
Low-level clock input voltage, V} (4) (see Note 2) 


Operating free-air temperature, Ta 0 


NOTE 2: Thealgebraic convention where the most negative limit is designated as minimum is used inthis specification for logic voltage levels only. 
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3.5 SWITCHING CHARACTERISTICS OVER FULL RANGE OF RECOMMENDED 
OPERATING CONDITIONS (SEE FIGURES 6 AND 7) 


PARAMETER TESTCONDITIONS | MIN MAX | UNIT 

Data bus output enable time 
eines rs 
ee a ee) a 


Data bus output disable time to high-imyedance state 


External data output propagation delay time from 2 


3V 


RL =1.3k2 


TMS 5501 
OUTPUT 


Ae = 100 pF 


CL includes probe and jig capacitance 


LOAD CIRCUIT 


——— ol) FOR t(G) 


| | | rt 
twlo1)—-———w] ae! rt bp taint La) 


| | 
' | tw(qi2) +——_> | 1 ta) wigs bet (5) 
| 


¢1 


92 td(o1H-@2) je—§et ta(92-81) | 
pn AT 2 Se Ce tt Me 

| 

SO 


ee 'su(CE)—e——o th(CE)-+¢——ol | 1 
792 <x I | iUXxx KK KA 
l SERRE REE 


ENABLE 


SYNC \ | 
| 
tsu(da)—+<———»| th(da) ~— 
| | I 
bo a | K OUTPUT DATA VALID re 
tsu(da)--e——l thida)agii—e | H | 
D1 \ OUTPUT DATA VALID Fg 
l 1 | | 
re NAN = | 
D2-D7 "SKE DU rerererererere: | = 
kee—et- tsu(ad) ! be——el-thiad) 
A0-A3 
EXTERNAL ! } 
INPUTS ROY 


NOTE: For «1 or 92 inputs, high an@ low timing points are 90% and 10% of VIH(e)- Allother timing points are the 50% tevel. 


FIGURE 6—READ CYCLE TIMING 
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BOOK —_INPUTDATA) —_—Y ROX 
DO, D1 OY" INPUT DATA IPRS SS SY 
| 
or A xxx V7 <4 ~ KK KKK) xx 
D2-D7 OOOO eR DON'T CARE SOK RRO 
A0-A3 O55 
EXTERNAL 


! 
OUTPUTS PREVIOUS EXTERNAL OUTPUT DATA x NEW DATA 


NOTE: For $1 and $2 inputs, high and low timing points are 90% and 10% of VIH(@). All other timing points are the 50% level. 


FIGURE 7—WRITE CYCLE TIMING 
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NOTES: 1. The RST instruction occurs during the output data valid time of tne read cycle. 
2. All timing points are 50% of Viyy. 


FIGURE 8—SENSOR/INTERRUPT TIMING 
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TMS 8080 MICROPROCESSOR 


1. ARCHITECTURE 
1.1. INTRODUCTION 


The TMS 8080 is an 8-bit parallel central processing unit (CPU) fabricated on a single chip using a high-speed N-channel 
silicon-gate process. (See Figure 1). A complete microcomputer system with a 2-us instruction cycle can be formed by 
interfacing this circuit with any appropriate memory. Separate 8-bit data and 16-bit address buses simplify the interface 
and allow direct addressing of 65,536 bytes of memory. Up to 256 input and 256 output ports are also provided with 
direct addressing. Control signals are brought directly out of the processor and all signals, excluding clocks, are TTL 
compatible. 


1.2 THE STACK 


The TMS 8080 incorporates a stack architecture in which a portion of external memory is used as a pushdown stack for 
storing data from working registers and internal machine status. A 16-bit stack pointer (SP) is provided to facilitate 
stack location in the memory and to allow almost unlimited interrupt handling capability. The CALL and RST (restart) 
instructions use the SP to store the program counter (PC) into the stack. The RET (return) instruction uses the SP to 
acquire the previous PC value. Additional instructions allow data from registers and flags to be saved in the stack. 


1.3. REGISTERS 


The TMS 8080 has three categories of registers: general registers, program control registers, and internal registers. The 
general registers and program control registers are listed in Table 1. The internal registers are not accessible by the 
programmer. They include the instruction register, which holds the present instruction, and several temporary storage 
registers to hold internal data or latch input :nd output addresses and data. 
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BUS BUS I1/0) 


FLAG 
REGISTER 


BCD 
CORRECT 


HIGH ORDER 


REGISTER 
FILE CONSTANT 
GENERATOR ¥ 
REGISTER 
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REGISTER 
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DECREMENTER REGISTER 


INSTRUCTION REGISTER 


TIME AND | cars 
CONTROL ; ™ 


FIGURE 1—TMS 8080 FUNCTIONAL BLOCK DIAGRAM 
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THE ARITHMETIC UNIT 


Arithmetic operations are performed in an 8-bit parallel arithmetic unit that has both binary and decimal capabilities. 
Four testable internal flag bits are provided to facilitate program control, and a fifth flag is used for decimal 
corrections. Table 2 defines these flags and their operation. Decimal corrections are performed with the DAA 
instruction. The DAA corrects the result of binary arithmetic operation on BCD data as shown in Table 3. 


STATUS AND CONTROL 


Two types of status are provided by the TMS8080. Certain status is indicated by dedicated control lines. Additional 
status is transmitted on the data bus during the beginning of each instruction cycle (machine cycle). Table 4 indicates 
the pin functions of the TMS8080. Table 5 defines the status information that is presented during the beginning of each 
machine cycle (SYNC time) on the data bus. 


1/O OPERATIONS 


Input/output operations (1/O) are performed using the IN and OUT instructions. The second byte of these instructions 
indicates the device address (256 device addresses). When an IN instruction is executed, the input device address 
appears in duplicate on A7 through AO and A15 through A8, along with WO and INP status on the data bus. The 
addressed input device then puts its input data on the data bus for entry into the accumulator. When an OUT 
instruction is executed, the same operation occurs except that the data bus has OUT status and then has output data. 


Direct memory access channels (DMA) can be OR-tied directly with the data and address buses through the use of the 
HOLD and HLDA (hold acknowledge) controls. When a HOLD request is accepted by the CPU, HLDA goes high, the 
address and data lines are forced to a high-impedance or ‘‘floating’’ condition, and the CPU stops until the HOLD 
request is removed. 


Interfacing with different speed memories is easily accomplished by use of the WAIT and READY pins. During each 
machine cycle, the CPU polls the READY input and enters a wait condition until the READY line becomes true. When 
the WAIT output pin is high, it indicates that the CPU has entered the wait state. 


Designing interrupt driven systems is simplified through the use of vectored interrupts. At the end of each instruction, 
the CPU polls the INT input to determine if an interrupt request is being made. This action does not occur if the CPU is in 
the HOLD state or if interrupts are disabled. The INTE output indicates if the interrupt logic is enabled (INTE is high). 
When a request is honored, the INTA status bit becomes high, and an RST instruction may be inserted to force the CPU 
to jump to one of eight possible locations. Enabling or disabling interrupts is controlled by special instructions (El or 
D1). The interrupt input is automatically disabled when an interrupt request is accepted or when a RESET signal is 
received. 


INSTRUCTION TIMING 


The execution time of the instructions varies depending on the operation required and the number of memory 
references needed. A machine cycle is defined to be amemory referencing operation and is either 3, 4, or 5 state times 
long. A state time (designated S) is a full cycle of clocks 91 and $2. (NOTE: The exception to this rule is the DAD 
instruction, which consists of 1 memory reference in 10 state times). The first machine cycle (designated M1) is either 4 
or 5 state times long and is the “‘instruction fetch’’ cycle with the program counter appearing on the address bus. The 
CPU then continues with as many M cycles as necessary to complete the execution of the instruction (up to a 
maximum of 5). Thus the instruction execution time varies from 4 state times (several including ADDr) to 18 (XTHL). 
The WAIT or HOLD conditions may affect the execution time since they can be used to control the machine (for 
example to ‘‘single step’) and the HALT instruction forces the CPU to stop until an interrupt is received. As the 
instruction execution is completed (or in the HALT state) the INT pin is polled for an interrupt. In the event of an 
interrupt, the PC will not be incremented during the next M1 and an RST instruction can be inserted. 


TABLE 1 
TMS 8080 REGISTERS 


DESIGNATOR LENGTH PURPOSE 


Accumulator 


Used for arithmetic, logical, and I/O operations 


B Register General or most significant 8 bits of double register BC 
C Register General or Jeast significant 8 bits of double register BC 
D Register General or most significant 8 bits of double register DE 
E Register General or least significant 8 bits of double register DE 
H Register General or most significant 8 bits of double register HL 
L Register General or least significant 8 bits of double register HL 


Program Counter Contains address of next byte to be fetched 


Stack Pointer Contains address of the last byte of data saved in 
the memory stack 

Five flags (C, Z, S, P, C1) 

NOTE: Registers B and C may be used together as a single 16-bit register, likewise, D and E, and H and L. 


TABLE 2 


Flag Register 


FLAG DESCRIPTIONS 


SYMBOL TESTABLE DESCRIPTION 
(e} YES C is the carry/borrow out of the MSB (most significant bit) of the ALU (Arithment Logic 


Unit). A TRUE condition (C= 1) indicates overflow for addition or underflow for 


subtraction. 


Z YES A TRUE condition (Z = 1) indicates that the output of the ALU is equal to zero. 
S YES A TRUE condition (S = 1) indicates that the MSB of the ALU output is equal to a one (1). 
P YES A TRUE condition (P =1) indicates that the output of the ALU has even parity (the 


number of bits equal to one is even). 


Ci NO C1isthe carry out of the fourth bit of the ALU (TRUE condition), C1 is used only for BCD 


correction with the DAA instruction. 


TABLE 3 
FUNCTION OF THE DAA INSTRUCTION 


Assume the accumulator (A) contains two BCD digits, X and ¥ 


acc 


ACCUMULATOR ACCUMULATOR 
BEFORE DAA AFTER DAA 

Cc 

0) 0 Ne ng 
0 1 Vi 0 Y+o 
0 e) Y 1 YEAIG 
1 ie) Y. 0 nd 

1 1 ¥ 0 Y+s6 
1 0 ¥ 1 YG 
) 0 Y 0 Y 
0 1 x ) Y+s6 
(0) 0 Nee 1 YG 


NOTE: The corrections shown in Table 3 are sufficient for addition. For subtraction, the programmer must account for the borrow 
condition that can occurand give erroneous results. The most straight forward method is to set A = 9946 and carry = 1. Then 
add the minuend to A after subtracting the subtrahend from A. 
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SIGNATURE | PIN 


A15 (MSB) 
Al4 

A13 

Al2 

All 

A10 

AQ 

A8 

A7 

A6 

AS 

A4 

A3 

A2 

Al 

AO (LSB) 


D7 (MSB) 
D6 
DS 
D4 
D3 
D2 
D1 
DO (LSB) 


Vss 
VBB 
Vcc 
VppD 
$1 


o2 


RESET 


HOLD 


INT 


INTE 


DBIN 


25 


[OO WON WHO 


= = 
= IN) 


N 
oO 


28 


22 


15 
12 


13 


14 


16 


17 


1/0 
OUT 


OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 


IN/OUT 
IN/OUT 
IN/OUT 
IN/OUT 
IN/OUT 
IN/OUT 
IN/OUT 
IN/OUT 


OUT 


OUT 


TABLE 4 
TMS 8080 PIN DEFINITIONS 


DESCRIPTION 
A15 through AO comprise the address bus. True memory or |/O device addresses appear on 
this 3-state bus during the first state time of each instruction cycle. 


D7 through DO comprise the bidirectional 3-state data bus. Memory, status, or I/O data is 


transferred on this bus. 


Ground reference 

Supply voltage (~5 V nominal) 
Supply voltage (5 V nominal) 
Supply voltage (12 V nominal) 
Phase 1 clock. 


Phase 2 clock. See page 19 for 1 and #2 timing. 


Reset. When active (high) for a minimum of 3 clock cycles, the RESET input causes the 
TMS 8080 to be reset. PC is cleared, interrupts are disabled, and after RESET, instruction 
execution starts at memory location 0. To prevent a lockup condition, a HALT instruction 
must not be used in location 0. 


Hold signal. When active (high) HOLD causes the TMS 8080 to enter a hold state and float 
(put the 3-state address and data bus in a high-impedance state). The chip acknowledges 
entering the hold state with the HLDA signal and will not accept interrupts until it leaves 
the hold state. 


Interrupt request. When active (high) INT indicates to the TMS 8080 that an interrupt is 
being requested. The TMS8080 polls INT during a HALT or at the end of an instruction. 
The request will be accepted except when INTE is low or the CPU is in the HOLD 
condition. 


Interrupts enabled. INTE indicates that an interrupt will be accepted by the TMS 8080 
unless it is in the hold state. INTE is set to a high logic level by the El (Enable Interrupt) 
instruction and reset to a low logic level by the DI (Disable Interrupt) instruction. INTE is 


also reset when an interrupt is accepted and by a high on RESET. 


Data bus in. DBIN indicates whether the data bus is in an input or an output mode, 


(high = input, low = output), 
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TABLE 4 (CONTINUED) 


SIGNATURE | PIN 1/0 DESCRIPTION 

WR 18 OUT Write. When active (tow) WR indicates a write operation on the data bus to memory or to an 
1/O port. 

SYNC 19 OUT Synchronizing control line. When active (high) SYNC indicates the beginning of each 


machine cycle of the TMS8080. Status information is also present on the data bus during 


SYNC for external latches. 
HLDA 21 OUT Hold acknowledge. When active (high) HLDA indicates that the TMS8080 is in a hold state. 


READY 23 IN Ready control line. An active (high) level indicates to the TMS 8080 that an external device 
has completed the transfer of data to or from the data bus. READY is used in conjunction 


with WAIT for different memory speeds. 


WAIT 24 OUT Wait status. When active (high) WAIT indicates that the TMS8080 has entered a wait state 
pending a READY signal from memory. 


TABLE 5 
TMS 8080 STATUS 
SIGNATURE | DATA BUS BIT DESCRIPTION 


Interrupt acknowledge. 


Indicates that current machine cycle will be a read (input) (high = read) or a write (output) 


(low = write) operation. 
Indicates that address is stack address from the SP. 
HALT instruction acknowledge. 


Indicates that the address bus has an output device address and the data bus has output 


data. 
Indicates instruction acquisition for first byte. 


Indicates address bus has address of input device. 


Indicates that data bus will be used for memory read data. 


2. TMS 8080 INSTRUCTION SET 


2.1 INSTRUCTION FORMATS 


TMS 8080 instructions are either one, two, or three bytes long and are stored as binary integers in successive memory 
locations in the format shown below. 


One-Byte Instructions 


D7 D6 D5 D4 D3 D2 D1 DO OP CODE 


Two-Byte Instructions 


| D7 D6 D5 D4 D3 D2 D1 DO OP CODE 
D7 D8 D5 D4 D3 D2 D1 DO OPERAND 


Three-Byte Instructions 


D7 D6 D5 D4 D3 D2 D1 DO OP CODE 


D7 D6 D5 D4D3 D2D1 DO LOW ADDRESS OR OPERAND 1 


D7 D6 D5 D4 D3 D2 D1 DO HIGH ADDRESS OR OPERAND 2 


2.2. INSTRUCTION SET DESCRIPTION 


Operations resulting from the execution of TMS 8080 instructions are described in this section. The flags that are affected by 
each instruction are given after the description. 


2.2.1 INSTRUCTION SYMBOLS 


SYMBOL DESCRIPTION 
<b2> Second byte of instruction 
<b3> Third byte of instruction 
ra Register # Register Name 
000 B 
001 Cc 
010 D 
011 E 
100 H 
101 L 
111 A 
tb Register # Register Name 
00 BC 
01 DE 
10 HL 
11 SP 
To Register # Register Name 
ee aa es: ree 
1 DE 
td Register # Register Name 
pie ae BC 
01 DE 
10 HL 
td Least significant 8 bits of rq 
‘dH Most significant 8 bits of rg 
f Flags True condition 
Zero (Z) Result is zero 
Carry (C) Carry/borrow out of MSB is one 
Parity (P) Parity of result is even 
Sign (S) MSB of result is one 
Carry 1(C1) Carry out of fourth bit is one 
M Memory address defined by registers H and L 
() Contents of specified address or register 
eal Contents at address contained in specified register 
= Is transferred to 
- Exchange 
Am Bit m of A register (accumulator) 
{} Flags affected 
b2 Single byte immediate operand 
b3b2 Double byte immediate operand 
(nnn)g (nnn) is an octal (base 8) number 


2.2.2 ACCUMULATOR GROUP INSTRUCTIONS 


MNEMONIC 


ACI 


ADC 
ADC 
ADD 


ADD 
ADI 
ANA 


ANA 
ANI 
CMA 
CMC 
CMP 


cmp 
CPI 
DAA 


RRC 


OPERANDS 


b2 


ta 


b2 


BYTES 


2 


MCYCLES/ 


STATES 


2/7 


2/7 
1/4 
2/7 


1/4 
2/7 
2/7 


1/4 
2/7 
1/4 
1/4 
2/7 


1/4 
2/7 
1/4 


1/10 


4/13 
2/7 
2/7 


1/4 
2/7 
1/4 


1/4 
1/4 


1/4 


DESCRIPTION 
(A) —(A) + <bg>+(carry), add the second byte of the 
instruction and the contents of the carry flag to register A and 
place in A. |C,Z,S,P,C1} 


(A) ~ (A) + (M) + (carry). { C,Z;S,P,C1 | 
(A) «= (A) + (rg) + (carry). | C,Z,S,P,C1 } 
(A) — (A) + (M), add the contents of M to register A and place in 
A. \C,Z,S,P,C1} 
(A) < (A) + (rg).4C,Z,S,P,C1 | 
(A) — (A) + <bg>. {C,Z,S,P,C1} 
(A) — (A) AND (M), take the logical AND of M and register A 
and place in A. The carry flag will be reset low. {C,Z,S,P,c1} 
(A) — (A) AND (rg). {C,Z,S,P,C1 } 
(A) — (A) AND <b>. {C,Z,S,P,C1 } 
(A) + (A), complement A. 
(carry) — (carry), complement the carry flag. {C } 
(A) — (M), compare the contents of M to register A and set the 
flags accordingly. { C,Z,S,P,C1| 

(A)=(M) 2Z2=1 

(A) # (M) Z=0 

(A)<(M) C=1 

(A)>(M) C=0 
(A) — (rg). {C,Z,S,P,C1 } 
(A)—<bg>. {C,2,S,P,C1} 
(A)<BCD correction of (A). The 8 bit A contents is corrected to 
form two 4 bit BCD digits after a binary arithmetic operation. A 
fifth flag C1 indicates the overflow from Ag. The carry flag C 
indicates the overflow from A7 (See Table 3). {C,Z,S,P,C1 f 
(HL) = (HL) + (rp), add the contents of double register rp, to 
double register HL and place in HL. \c} 
(A)-[<b3> <b2>] 
(A)-[(re)] 
(A) + (A) OR (M), take the logical OR of the contents of M and 
register A and place in A. The carry flag will be reset. 
{c,z,s,P,c1} 
(A) = (A) OR (rg).{C,Z,S,P,C1} 
(A) — (A) OR <bg>. {C,Z,S,P,C1} 
Am+1*Am, Aot(carry), (carry)-(A7). Shift the contents of 
register A to the left one bit through the carry flag. {c | 
Am=Am*1, Aze(carry), (carry)Ag. { C | 
Am+1*Am, Aot-A7 (carry)(A7). Shift the contents of register 
A to the left one bit. Shift A7 into A and into the carry 
flag. {|C \ 
Am=Am#+1, A7Ao, (carry)(Ag). {C } 


M CYCLES/ 


MNEMONIC OPERANDS BYTES STATES 


SBB M 1 2/7 
SBB ts 1 1/4 
SBI b2 2 2/7 
STA b3b2 3 4/13 
STAX le 1 2/7 
STC 1 1/4 
SUB M 1 2/7 
SUB ta 1 1/4 
SUI bg 2 2/7 
XRA M 1 2/7 
XRA e 1 4 
XRI b2 2 2/7 


2.2.3 INPUT/OUTPUT INSTRUCTIONS 


M CYCLES/ 
MNEMONIC OPERANDS’ BYTES STATES 
IN b2 2 3/10 
OUT b2 2 3/10 


2.2.4 MACHINE INSTRUCTIONS 


M CYCLES/ 


MNEMONIC OPERANDS BYTES STATES 


HLT 1 2/7 


NOP 1 1/4 


DESCRIPTION 


(A)+-(A)—(M)—(carry), subtract the contents of M and the 

contents of the carry flag from register A and place in A. Two's 

complement subtraction is used and a true borrow causes the 

carry flag to be set (underflow condition). \C,Z,5,P,C1} 

(A)-(A)—(rg)—(carry). {C,Z,S,P,C 1 

(A)—(A)—<b2>—(carry). {C,Z,S,P,C1} 

[<b3> <b2>]<-(A), store contents of A in memory address 

given in bytes 2 and 3. 

[(re)} =(A), store contents of A in memory address given in BC 

or DFE, 

(carry)—1, set carry flag to a 1 (true condition). 

(A)+-(A)—(M), subtract the contents of M from register A and 

place in A. Two's complement subtraction is used and a true 

borrow causes the carry flag to be set (underflow condition). 

| C,Z,S,P,C1} 

(A)“(A)—(rg),{ C,Z,S,P,C1 | 

(A)-(A)—<b >. {C,Z,S,P,C1} 

(A)—(A) XOR (M), take the exclusive OR of the contents of M 

and register A and place in A. The carry flag will be reset. 
{c,z,S,P,c1} 

(A)<(A) XOR (rg). {C,Z,S,P,C1 

(A)-(A) XOR <by>. {C,Z,S,P,C1} 


DESCRIPTION 
(A)—(input data from data bus), byte 2 is sent on bits A7-AO 
and A15-A8 as the input device address. INP status is given on 
the data bus. 
(Output data)—(A), byte 2 is sent on bits A7-AO and A15-A8 as 
the output device address. OUT status is given on the data bus. 


DESCRIPTION 
Halt, all machine operations stop. All registers are maintained. 
Only an interrupt can return the TMS 8080 to the run mode, 
Note that a HLT should not be placed in location zero, 


otherwise after the reset pin is active, the TMS 8080 will enter a 
nonrecoverable state (until power is removed), i.e., in halt with 


interrupts disabled. This condition also occurs if a HLT is 
executed while interrupts are disabled. HLTA status is given on 
the data bus. 

(PC)—(PC)+1, no operation. 


2.2.5 PROGRAM COUNTER AND STACK CONTROL INSTRUCTIONS 


MNEMONIC 


CALL 


Conditional call instructions for true flags: 


(f) 


CC (carry) 
CPE (parity) 
CM (sign) 
CZ (zero) 


Conditional call instructions for false flags: 


(f) 


CNC (carry) 
CPO (parity) 
CP (sign) 
CNZ (zero) 
of 
El 
JMP. 


Conditional jump instructions for true flags: 


(f) 


JC (carry) 
JPE (parity) 
JM (sign) 
JZ (zero) 


Conditional jump instructions for false flaas: 


(f) 
JNC (carry) 
JPO (parity) 
JM (sign) 
JNZ (zero) 
PCHL 
POP 


POP 
PUSH 


PUSH 
RET 


OPERANDS 


b3b2 


b3b2 
b3b2 
b3b2 
b3b2 


b3b2 
b3b2 
b3b2 
b3b2 


b3b2 


b3b2 
b3b2 
b3b2 
b3b2 


b3b2 
b3b2 
b3b2 
b3b2 


PSW 


'd 
PSW 


'd 


BYTES 


3 


WwW w 


3 


wo ww 


3 


- = WWW WwW 


M CYCLES/ 


STATES 


5/17 


5/17 (Pass) 
3/11 (Fail) 


5/17 (Pass) 
3/11 (Fail) 


1/4 


1/4 


3/10 


3/10 


3/10 


1/5 
3/10 


3/10 
3/11 


3/11 
3/10 


DESCRIPTION 
{(SP)—1] [(SP)—2]—(PC), (SP)<(SP)—2, (PC)-<b3> <b>, 
transfer PC to the stack address given by SP, decrement SP 
twice, and jump unconditionally to address given in bytes 2 and 
33 


If (f) = 1, [(SP)—1] [(SP)—2] (PC), (SP)--(SP)—2, (PS)—<b3> 
<b2>, otherwise (PC)-—(PC)+3. !f the flag specified, f, is 1, then 


execute a call. Otherwise, execute the next instruction. 


If (f) = 0, [(SP)—1] [(SP)—2] —(PC), (SP)—(SP)—2, (PC)--<b3> 
<b2>, otherwise (PC)—(PC)+3. 


Disable interrupts. INTE is driven false to indicate that no 
interrupts will be accepted. 

Enable interrupts. INTE is driven true to indicate that an 
interrupt will be accepted. Execution of this instruction is 
delayed to allow the next instruction to be executed before the 
INT input is polled. 

(PC)«<b3> <bg2>, jump unconditionally to address given in 
bytes 2 and 3. 


If (f) = 1, (PC)+<b3><b2>, otherwise (PC)+(PC)+3. If the flag 
specified, f, is 1, execute a JMP. Otherwise, execute the next 


instruction, 


If (f) =0, (PC)}“<b3> <by>, othewise (PC)+-(PC)+3. 


(PC)(HL) 


(F)<((SP)], (A)<-[(SP)+1], (SP)<-(SP)+2, restore the Jast 


stack values addressed by SP into A and F. Increment SP twice. 


(rgLJ<-LISP)], (rgH}—UISP)+1], (SP}E(SP}+2 
((SP)—1]<(A), [(SP)—2]<-(F), (SP)<-(SP)—2, save the contents 


of A and F into the stack addressed by SP. Decrement SP twice. 


[(SP)—1) —(rgL), {(SP)—2] —(rgH), (SP)“(SP)—2. 
(PC)<—{(SP)] [(SP)+1], (SP)<-(SP)+2, return to program at 
memory address given by last values in the stack. The SP is 


incremented by two. 


M CYCLES/ 
MNEMONIC OPERANDS BYTES STATES DESCRIPTION 


Conditional return instructions for true flags: 


(f) 3/11 (Pass) Wf (f) = 1, (PC)-[((SP)] [(SP+1], (SP)—(SP)+2. If the flag 
RC. (carry) Cc 1 1/5 (Fail) specified, f, is 1, execute a RET. Otherwise, execute the next 
RPE (parity) P 1 instruction. 
RM_ (sign) s 1 
RZ (zero) zZ 1 
Conditional return instructions for talse flags: 

(f) 3/11 (Pass) If (f) = 0, (PC)—{(SP)] [(SP)+1], (SP):-(SP)+2. 
RNC (carry) Cc 1 1/5 (Fail) 
RPO (parity) P 1 
RP (sign) Ss 1 
RNZ (zero) Zz 1 

RST 1 3/11 ((SP)—1] [(SP)—2] <(PC) (SP)--(SP)--2, (PC)0000R0g where 


R is a 3 bit field in RST (RST=3R7g). Transfer PC to the stack 
address given by SP, decrement SP twice, and jump to the 
address specified by R. 

SPHL 1 1/5 (SP)<(HL). 


2.2.6 REGISTER GROUP INSTRUCTIONS 


M CYCLES/ 
MNEMONIC OPERANDS BYTES STATES DESCRIPTION 
DCR M 1 3/10 (M)<(M)—1, decrement the contents of memory location 
specified by H and L. {Z,S,P,C1} 
DCR Tg 1 1/5 (rg)<(rg)—1, decrement the contents of register rg. }Z,S,P,C1 } 
DCX Tb 1 1/5 (rp)<—(rh)—1, decrement double registers BC, DE, HL, or SP. 
INR M 1 3/10 (M)~(M)+1, increment the contents of memory location 
specified by H and L.|Z,S,P,C1 } 
INR Tg 1 1/5 (rgl-(rg)+1, increment the contents of register rg. |Z,S,P,C1} 
INX Tb 1 1/5 (rh)<(rph)+1, increment double registers BC, DE, HL, or SP. 
LHLD b3b2 3 5/16 (Li- [<b3> <b2>]; (H)- [<b3> <b2>+1], load registers H 
and L with contents of the two memory locations specified 
by bytes 3 and 2. 
LXxI rhb3b2 3 3/10 (rpH)-<b3>:; (rpL)+<b2>, toad double registers BC, DE, HL, 
or SP immediate with bytes 3, 2, respectively. 
MvVI M,b2 2 3/10 (M)«<b2>, store immediate byte 2 in the address specified by 
HL 
MMVI rgb2 2 2/7 (rg)—<b2>, load register rg immediate with byte 2 of the instruc- 
tion. 
MOV Mra 1 2/7 (M)--(rg), store register rg in the memory location addressed by 
H and L. 
MOV rgM 1 2/7 (rg)-(M), load register rg with contents of memory addressed by 
HL, 
MOV ralla2 1 1/5 (rg1)<(raz), load register ray with contents of raz, raz contents 


remain unchanged, 

SHLD b3b2 3 5/16 [<b3> <b2>]+<(L); [<b3> <b 2>+1)]--(H), store the contents 
of H and L into two successive memory locations specified by 
bytes 3 and 2. 

XCHG 1 1/4 (H)—(D); (L)—(E), exchange double registers HL and DE 

XTHL 1 5/18 (L)-[(SP)], (H)—[(SP)+1], (SP)=(SP), exchange the top of the 
stack with register HL. 


2.3. INSTRUCTION SET OPCODES ALPHABETICALLY LISTED. 


MNEMONIC BYTES 


ACI 2 
ADC M 1 
ADCr 1 
ADD M 1 
ADD r 1 
ADI 2 
ANAM 1 
ANAr 1 
ANI 2 
CALL 3 
cc 3 
CM 3 
CMA 1 
CMC 1 
CMP M 1 
CMP r 1 
CNC 3 
CNZ 3 
CP. 3 
CPE 3 
CPI 2 
CPO 3 
CZ 3 
DAA 1 


DESCRIPTION 


Add immediate to A with carryt 
Add memory to A with carryt 


Add register to A with carryt 


Add memory to At 
Add register to AT 


Add immediate to At 
AND memory with At 
AND register with At 


AND immediate with At 
Call unconditional 

Call on carry 

Call on minus 
Complement A 
Complement carry? 
Compare memory with At 


Compare register with A 


Call on no carry 

Call on no zero 

Call on positive 

Call on parity even 

Compare immediate with at 
Call on parity odd 

Call on zero 

Decimal adjust at 


REGISTER 


AFFECTED 


> Fr 2m oe: wo 


rp>rFiéméimoeaDn 


> aE. Ms 3G): 40a: 


por 2 me OF 


* Two possible cycle times (11/17) indicate instruction cycles dependent on condition flags. 


' all flags (C, Z, S, P, C1) affected 


‘-Only carry flag affected. 


D-12 


POSITIVE-LOGIC 


HEX OPCODE 
\D7-D4, \D3-—D0, 
Cc E 
8 E 
8 8 
8 9 
8 A 
8 B 
8 Cc 
8 D 
8 F 
8 6 
8 0) 
8 1 
8 2 
8 3 
8 4 
8 5 
8 7 
c 6 
A 6 
A 0) 
A 1 
A 2 
A 3 
A 4 
A 5 
A 7 
E 6 
cC D 
D Cc 
F Cc 
2 F 
3 F 
B E 
B 8 
B 9 
B A 
B B 
B c 
B D 
B F 
D 4 
Cc 4 
F 4 
E Cc 
F E 
E 4 
¢c Cc 
2 7 


CLOCK 


CYCLES* 


7 
7 
4 


MNEMONIC BYTES 


DAD B 
DADE 
DAD H 
DAD SP 
DCRM 
DCRr 


a ee a ea | 


DCX B 
DCX D 
DCX H 
DCX SP 


DI 
El 


HLT 
IN 
INR M 
INRr 


emp er nN -P- BaPa aoa = = 


INX B 
INX D 
INX H 
INX SP 
JC 

JM 
JMP 
JNC 
JNZ 
JP 

JPE 
JPO 
JZ 
LDA 
LDAX B 
LDAX D 
LHLD 
LXIB 
LXID 
LXIH 
LXISP 


WWWwW PF FBFwwwWWdwWwWwW WwW = = 


WwW 


fonty carry flag affected. 
SALI flags except carry affected. 


DESCRIPTION 


Add B&C to H&L? 

Add D&E to H&L* 

Add H&L to H&LE 

Add stack pointer to H&L t 
Decrement Memory § 


Decrement Register ® 


Decrement B&C 
Decrement D&E 
Decrement H&L 
Decrement stack pointer 


Disable interrupts 
Enable interrupts 


Halt 
Input 
{ncrement memory § 


. & 
Increment registers 


Increment B&C register 
Increment D&E register 
Increment H&L register 
Increment stack pointer 

Jump on carry 

Jump on minus 

Jump unconditional 

Jump on no carry 

Jump on no zero 

Jump on positive 

Jump on parity even 

Jump on parity odd 

Jump on zero 

Load A direct 

Load A indirect 

Load A indirect 

Load H&L direct 

Load immediate register pair B&C 
Load immediate register pair D&E 
Load immediate register 


Load immediate stack pointer 


REGISTER 


AFFECTED 


Sr =m So Oo 


>rPriMmgaD 


POSITIVE-LOGIC 
HEX OPCODE 


\07-D4, 


WNP ONFOWDMMIMNA”ATANTNDBOWNH- DOWNHNHHFKHOADAWBOAN TMIANUWNHHEH OWNNRFBKPOOWWNH AH ODO 


\ 03—D0, 


m~=s=-2 42D DPPPNPNNNWPPHWOWWWANAKAHKA FHA WHAAWHWNWDADOVCOHVVTHV OHHH OO © 


CLOCK 


CYCLES 


10 
10 
10 
10 
10 
5 


MNEMONIC 


MOV M,r 


MOV r,M 


MOV 11,12 


BYTES 


1 


DESCRIPTION 


Move register to memoiy 


Move memory to register 


Move register to register 


REGISTER 


AFFECTED 


ie] 


SP Sir Se IM) i Qo Oe? Bi ie Se SO 


B,B 


POSITIVE-LOGIC 


HEX OPCODE 
\07-D4, \D3-—D0, 


DOAananoaononunnanau4wn»ieanwiau4»a»ua»»ua4n»nunst BpHH HH HPHPHB HHP HPP pPN OO HO HF BNYNANvNvvuwvwnan 


ON OB WNHHPOTBOVOA PA AHN OO KHBWNH BFPO TDA WP HO ANNO BWNHeROMMAMaAMaAanNoOBKRwWNHARO 


CLOCK 


CYCLES 


7 


POSITIVE-LOGIC 


REGISTER HEX OPCODE CLOCK 
MNEMONIC BYTES DESCRIPTION AFFECTED \D7-D4, \D3-D0, CYCLES* 
MOV 14, r2 1 Move register to register (continued) EC 6 9 
L,D 6 A 
LJe 6 B 
Ll 6 Cc 
EE 6 D 
L,A 6 F 
A,B a 8 
A,C y 9 
A,D 7 A 
A,E 7 B 
A,H ed; Cc 
A,L d D 
A,A 7 F 
MVIM 2 Move immediate memory 3 6 10 
MVIr 2 Move immediate register B 0 6 
Cc 0 E 
D 1 6 
E 1 E 
H 2 6 
(e 2. E 
A 3 E 
NOP 1 No operation 4 0 0 
ORAM 1 OR memory with At B 6 
ORAr 1 OR register with AT B B 0) 
Cc B 1 
D B 2 
E B 3 
H B 4 
Le B 5 
A B 7 
ORI 2 OR immediate with AT F 6 7 
OUT 2 Output D 3 10 
PCHL 1 H&L to program counter E 9 5 
POP B 1 Pop register pair B&C off stack GC 1 10 
POP D 1 Pop register pair D&E off stack D 1 10 
POP H 1 Pop register pair H&L off stack E 1 10 
POP PSW 1 Pop A and flags off stackt F 1 10 
PUSH B 1 Push register pair B&C Cc 5 11 
PUSH D 1 Push register pair D&C D 5 11 
PUSH H 2 Push register pair H&L on stack E 5 11 
PUSH PSW 1 Push A and Flags on stack F 5 11 
RAL 1 Rotate Aleft through carry = 1 7 4 
RAR 1 Rotate A right through carry!: 1 F 4 
RC 1 Return on carry D 8 5/11 
RET 1 Return G 9 10 
RLC 1 Rotate A left! 0 7 4 
RM 1 Return on minus F 8 5/11 
RNC 1 Return on no carry D ie} 5/11 
RNZ 1 Return on no zero Cc 0 5/11 
RP 1 Return on positive F ie} 5/11 


* Two possible cycles times (11/17) indicate instruction cycles dependent on condition flags. 
Tall flags (C, Z, S, P, C1) affected, 
+Only carry flag affected. 


MNEMONIC BYTES 


RPE 
RPO 
RRC 
RST 


— = tet 


RZ 1 
SBB M 1 
SBBr 1 


SBI 
SHLD 
SPHL 
STA 
STAX B 
STAX D 
STC 
SUB M 
SUB r 


—- = |= = Wo WN 


SUI 
XCHG 
XRAM 
XRAr 


—= = = A) 


XRI 2 
XTHL 1 


DESCRIPTION 


Return on parity even 
Return on parity odd 
Rotate A right! 
Restart 


Return on Zero 
Subtract memory from A with borrowt 


Subtract register from A with borrowt 


Subtract immediate from A with borrowt 
Store H&L direct 

H&L to stack pointer 

Store A direct 

Store A indirect 

Store A indirect 

Set carry + 

Subtract memory from At 


Subtract register from At 


Subtract immediate from At 

Exchange D&E, H&L registers 
Exclusive OR memory with At 
Exclusive OR register with At 


Exclusive OR immediate with At 
Exchange top of stack H&L 


POSITIVE-LOGIC 


REGISTER HEX OPCODE 


AFFECTED \D7-D4, \D3-D0, 
E 8 


E 0 
0 F 

PC<~00001 6 Cc 7 
PC-0008 4g Cc F 
PC:-001046 D 7 
PC-001816 D F 
PC+-002016 E 7 
PC-00281 6 E F 
PC+-003046 F 7 
PC-003846 F F 
Cc 8 

9 E 

B 9 8 

Cc 9 9 

D 9 A 

E 9 B 

H 9 Cc 

L 9 D 

A 9 F 

D E 

2 2 

F 9 

3 2 

0 2 

1 2 

3 7 

9 6 

B 9 0 

Cc 9 1 

D 9 2 

E 9 3 

H 9 4 

L 9 5 

A 9 7 

D 6 

E B 

A E 

B A 8 

s A 9 

D A A 

E A B 

H A Cc 

L A D 

A A F 

E E 

E 3 


*Two possible cycles times (11/17) indicate instruction cycles dependent on condition flags. 


TAII flags (C, Z, S, P, C1) affected. 
«Only carry flag affected. 


CLOCK 


CYCLES* 


5/11 
5/11 
4 
11 


5/11 


Bn PN 
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3. TMS 8080 ELECTRICAL AND MECHANICAL SPECIFICATIONS 


3.1 ABSOLUTE MAXIMUM RATINGS OVER OPERATING FREE-AIR TEMPERATURE RANGE 
(UNLESS OTHERWISE NOTED)* 


Supply voltage, Vcc (see Note 1) Sa mie Sah hat Glace al Ot eats ae eS ee ee eee OLN tO ZO AV, 
Supply voltage, Vpp (see Note 1 bie ee Bowe a REGS Bow bee dw oe ae we CSO NitOF20NY 
Supply voltage, Vsg (see Note 1) $2 eo oa OO we Se De ew oe eee oO ee ORNS 20, 
All input and output voltages (see Note 1) . 2... . we ee ee ee ee ee. 6 -0.3V to 20V 
Gontinueus:poWer dissipation: =< 6-93 & 3 2 a & we a «= Ow ew ee kD ew we eee ww a we a ee ew LOW 
Operating free-air temperature range... 1 ee ee 0°C to 70°C 
Storage temperature range . 1 ww we —65°C to 150°C 


*Stresses beyond those listed under ‘‘Absolute Maximum Ratings’’ may cause permanent damage to the device. This is a stress rating only 
and functional operation of the device at these or any other conditions beyond those indicated in the ‘‘Recommended Operating 
Conditions’’ section of this specification is not implied. Exposure to absolute-maximum-rated conditions for extended periods may affect 
device reliability. 

NOTE 1: Under absolute maximum ratings voltage values are with respect to the normally most negative supply voltage, Vgg (substrate). 

Throughout the remainder of this data sheet, voltage values are with respect to Vssg unless otherwise noted. 


3.2 RECOMMENDED OPERATING CONDITIONS 


MIN NOM MAX |JUNIT 


Supply voltage, Veg —4.75 -5 -5.25] V 


Supply voltage, Vcc 4.75 5 5.25] V | 
Supply voltage, Vpp 1a 2 ime) v | 
Supply voltage, Vss (0) Vv 
‘High-level input voltage, Vj} (all inputs except clocks) (see Note 2) 33 Vect1] Vv 
High-level clock input voltage, ViH(o) Vpp-1 Vpptl) V | 
Low-level input voltage, Vj, (all inputs except clocks) (see Note 3) —1 0.8) Vio 
Low-level clock input voltage, Vj__() (see Note 3) =i 0.6] V 
Operating free-air temperature, Ta 0 70 Cc 


3.3. ELECTRICAL CHARACTERISTICS OVER FULL RANGE OF RECOMMENDED OPERATING CONDITIONS 
(UNLESS OTHERWISE NOTED) 


PARAMETER TEST CONDITIONS MIN TYPT MAX |UNIT 


Input current (any input except 


ly V;=OVtoVceE 


clocks and data bus) 


l(a) Clock input current Vi(o) =O V to Vpp 
'1(DB) Input current, data bus Vi(DB) =O V to Vcc 
rae Address or ee bus input Vi(aa) OF Vi(pB) = Vcc 

current during hold Vi(ad) Or Vi(pB) =O V 
VOH High-level output voltage IOH = 100 LA 


IOL(DB) = 1.7 mA, 


VOL Low-level output voltage 
lo, = 0.75 mA (any output except DB) 


IBBlav) Average supply current from Veg 


\CClav) Average supply current from Vcc PPHunG at tela) = AG Ns, 


= 25° 
IDD(av) Average supply current from Vpp Ta a 
C, Capacitance, any input except clock Vcc = VoD = Vss = OV, 
Ci(o) Clock input capacitance Veep = —4.75 to —5.25 V, f = 1 MHz, 
Co Output capacitance All other pins at O V 


Tail typical values are at Ta = 25 ‘C and nominal voltages. 
NOTES: 2. Active pull-up resistors of nominally 2 k{2 will be switched onto the data bus when DBIN is high and the data input voltage is 
more positive than Vjyy min. 


3. The algebraic convention where the most negative limit is designated as minimum is used in this specification for logic voltage 
levels only. 


3.4 TIMING REQUIREMENTS OVER FULL RANGE OF RECOMMENDED OPERATING CONDITIONS 
(SEE FIGURE 2) 


MIN MAX |JUNIT 


ABE 
ala 


tela) Clock cycie time (see Note 5) 480 2000 

tr(a) Clock rise time 5 50 

te (c) Clock fall time 5 50} ns 
twat) Pulse width, clock 1 high 60 ns 
twlo2) Pulse width, clock 2 high 220 as || 
td(o1L-o2) Delay time, clock 1 low to clock 2 0) | ns | 
tg(o2-01) Delay time, clock 2 to clock 1 70 
td(o1H.02) Delay time, clock 1 high to clock 2 (time between leading edges) 130 
tsu(da-o1) Data setup time with respect to clock 1 50 ens 
tsu(da-<.2) Data setup time with respect to clock 2 150 pons | 
tsu(hold) Hold input setup time 140 Pons | 
tsu(int) Interrupt input setup time 180 ns 
tsu(rdy) Ready input setup time 120 ns 
thida) Data hold time (see Note 6) tpo(DBI) | ns | 
th(hold) Hold input hold time 0 
thlint) Interrupt input hold time 0) 
thirdy) Ready input hold time : 0 ns 


NOTES: 5S. te(es) = tg(a1b-A2) * te(2) * bw (42) * t#(Gh2) + ta(2-51) + tr(g1)- 480 ns < tei) < 2000 ns. 
6. The data input should be enabled using the DBIN status signal. No bus conflict can then occur and the data hold time 
requirement is thus assured. 


3.5 SWITCHING CHARACTERISTICS OVER FULL RANGE OF RECOMMENDED OPERATING CONDITIONS 
(SEE FIGURE 2) 


PARAMETER TEST CONDITIONS MIN MAX | UNIT 
tPD(ad) Propagation delay time, clock 2 to address outputs | 200] ns | 
220 


tPD(da) Propagation delay time, clock 2 todatabus 


tPD(cont) Propagation delay time, clocks to control outputs 
28 140 


tPD(DBI) 

tPD(int) Propagation delay time, clock 2 to INTE output 200 | ns 
Time for data bus to enter input mode tpD(DBI) | ns 
Disable time to high-impedance state 

; 120] ns 

during hold (address outputs and data bus) 

The time that the address outputs and output data will remain stable after WR goes high, twa and two 2 tq(@1H-O2)- 

The time between address outputs becoming stable and WR going low, taw <2 te(d) —td(@1H -62)—tr(g)— 120 ns. 


CL = 100 pF, 
RE =1.3k2 


Propagation delay time, clock 2 to DBIN output 


'DI 


The time between output data becoming stable and WR going low, tow 2 tc(@)— ta (1H -@2) ~ tr (@) — 150 ns. 
The following are relevant when interfacing to devices requiring Vjyy min of 3.3 V: 


a) Maximum output rise time (tTLH) from 0.8 V to 3.3 V is 140 ns with C\_ as specified for the propagation delay times above. 


b) Maximum propagation delay times when measured to V;ef(H) = 3 V (instead of 2 V) will be 60 ns more than as specified above with 
CL as specified. 


SV; 


Ru =1,.3k2 


T° 100 pF 


C__ includes probe and jig capacitance. 
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3.6 TERMINAL ASSIGNMENTS 


TMS 8080 


3.7. MECHANICAL DATA 


40-PIN CERAMIC PACKAGE 


2.020 MAX. 


0.600 + 0.010 
MIN 


_SEATING 41 
PLANE f 


0.018 +0 003-4 a 
0.010 Nom PIN SPACING 0.100 TP, 


(See Note A) 0.050 + 0.010 


NOTES: A. Thetrue-position pin spacing is 0.100 between centerltines. Each pin centerline is located within 0.010 
of its true longitudinal position relative to pins 1 and 40. 
B. All dimensions are in inches unless otherwise noted. 
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1.0 SAFETY PRECAUTIONS 


WARNING: The following precautions should be observed: 


ie 


Do not install, remove, or handle the picture tube in any 
manner unless shatter-proof goggles are worn. People not 
so equipped should be kept away while picture tubes are 
handled. Keep picture tube away from the body while 
handling. 


Part of the High Voltage is connected to the AC line 
directly. This circuitry, found on the Analog Module 
(100047), is isolated from the remainder of the circuitry 
by optical isolator, U3, and driver transformer, T101. 
Should service of the High Voltage be required it is 
recommended that an isolation transformer be inserted in 
the power line between the Intecolor®8001 and the AC 
supply before any service is performed. When the Chassis 
must be operated directly from the AC supply, the power 
plug should always be inserted in the correct polarity to 
connect the High Voltage common (emitter of Q5) to the 
ground side of the AC line. Check with a VOM or oscillo- 
scope to see if a potential exists between this point and 
a known earth ground. A zero reading should be obtained. 
If any voltage reading is obtained, reverse the power plug 
and recheck for zero meter reading. 


When service is required, observe the original lead dress. 
Extra precaution should be given to assure correct lead dress 
in the high voltage circuitry and video area. Where a short 
circuit has occurred, replace those components that indicate 
evidence of overheating. Always use the manufacturer's 
recommended replacement component. 


Ts 


a 


0. 
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HIGH VOLTAGE 


NOTE: THE NOMINAL HIGH VOLTAGE FOR THE INTECOLOR®8001 
17" or 19" TERMINAL IS 25 KV. THE HIGH VOLTAGE MUST 
NOT, UNDER ANY CIRCUMSTANCES, EXCEED 27.5KV. 


Each time a terminal's High Voltage requires servicing, 
measurements snould be made at normal viewing settings 
of the Brightness Control. This will afford assurance 
that; 


1. The High Voltage is within limits specified. 

2. The High Voltage regulation circuit is function- 
ing properly. 

3. X-Radiation is at a minimum. 


If the High Voltage measures abnormally high or the 

High Voltage Regulation Circuit is not functioning properly, 
the Terminal should be restored to normal operation through 
service or adjustments. (See 2.0.5 for High Voltage 
Adjustment procedure.) 


IT IS IMPORTANT TO USE AN ACCURATE AND RELIABLE HIGH 
VOLTAGE METER. 


X-RADIATION PRECAUTIONS 


The primary source of X Radiation in this Terminal is 
the picture tube. 


The tube utilized for the above mentioned function in 
the terminal is specifically constructed to limit X- 
Radiation emissions. 


For continued X-Radiation protection, the replacement tube 


must be the same type as the original, including suffix 
letter, or an ISC approved type. 
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INSTALLATION AND SERVICE ADJUSTMENTS 


SERVICING PRECAUTIONS 


Purity, Color, Temperature, and Convergence adjustments 
for the Intecolor®8001 are essentially the same as for 
conventional shadow mask color tubes. Certain pre- 
cautions should be taken, however, in servicing the 
Intecolor®8001 terminal. 


Some precautions to observe while servicing the solid 
state chassis are listed below: 


1. Always connect the ground lead of a test instrument 
to the chassis before connecting the positive lead; 
conversely, always remove the ground lead of a test 
instrument last. 


2. Do not check for high voltage by drawing an arc. Use 
a high voltage meter or a high voltage probe with a VOM. 


3. Do not bridge electrolytic capacitors since resultant 
surges may damage solid state devices. 


4. Some transistors are equipped with heat sinks. Do not 
operate the transistor with the heat sink removed. 


5. All soldering irons used where transistors and integrated 
chips are concerned should be 35 watt (6 volts) irons and 
grounded in such a way that no voltage will be applied to 
the solid state device during the soldering operation. 
This precaution is to prevent possible damage to the 
device due to excessive heat or voltage applied under 
no bias conditions. 


6. When servicing the video circuitry it is recommended that 


an oscilloscope of at least 100 MHZ bandwidth, such as 
the Tektronix 454A, be used. 
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AC LINE TAP SELECTOR 


The AC Line Tap Selector is located inside the chassis 
on the right hand side as viewed from the rear (See 
Figure 2.0.2.1). In areas having a LISVAC Line 
supply, this tap should be left in the 115 VAC 
position. Other taps are shown depending on the 

line voltage. 


VERTICAL DEFLECTION 


At 115 volts line voltage adjust the VERTICAL HEIGHT 
CONTROL, R3, (See Figure 2.0.3.1) and the VERTICAL 
POSITION CONTROL, R4, so that the picutre is centered 
and there is a 12' wide by 10" high display. A 
suitable display is found by filling up the screen 
with a single character or erasing the screen with 

a background color. 


HORIZONTAL DEFLECTION 


Adjust the HORIZONTAL WIDTH CONTROL, R6, (Analog 
Module, 100047) (See Figure 2.0.3.1) so that the 
picture has a 12" wide by 10" high display. 
HORIZONTAL CENTERING is accomplished by adjusting 
R3 on the rear edge of the Display Generator Card, 
100117. Adjusting the Pot R3 causes one character 
movements to the right or left of the screen. 


Blue /Wht 105 
Black/Wht 115 

F=_}-—— Black 
Green/Wht 125 Tap Selector 
Red/Wht 135 - 


AC LINE TRANSFORMER TAP SELECTION 
FIGURE 2.0.2.1 


Horizontal Horizontal 


Pincushion © (4) Width 


R7 R6 


Vertical 
Height 
OR’ 


Vertical Vertical 
Position (4) ® Pincushion 
R4 R5 


ANALOG MODULE (100047) PRINTED CIRCUIT BOARD BOTTOM VIEW 
FIGURE 2.0.3.1 
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HIGH VOLTAGE ADJUSTMENT 


Preset High Voltage Adjustment Control R8 (Analog 
Module 100047) to 1/2 clockwise, and Brightness 
Control R17, to maximum counterclockwise (minimum 
brightness). 


Remove the High Voltage Anode Cap from the tube and 
connect a Pomona #2900A or equivalent to the High 
Voltage Cap. CAUTION: BE SURE HV PROBE GROUND IS 
GROUNDED. INSURE THAT ANODE CAP IS ISOLATED FROM 
ALL PERSONS AND EQUIPMENT. Adjust High Voltage 
Control, Rs fer 25. kV. 


FOCUS ADJUSTMENT 


Create a full page of white dots on the CRT screen 
by utilizing the following procedure: 


1. Select Foreground Color - WHITE 
2. Select Background Color - BLACK 


3. Press keyboard '."' (period) and allow to 
repeat until screen is full of white dots. 


Adjust the FOCUS pot (found on the right side (viewing 
from rear) of the Analog Card mounting bracket. 

Remove the external case with 6 screws) for optimum 
focus over the entire screen. (See Figure 2.0.6.1) 


PURITY ADJUSTMENT 


The Intecolor®8001 should always be facing either north 

or south during purity adjustment. This assures that any 
effect of the earth's normal magnetic field upon beam landing 
will be negligible when the terminal is placed in its 

normal viewing location. 


The instrument should be at room temperature (60°F or above) 
for at least 30 minutes before set-up adjustments are made. 
Allow a minimum of ten minutes operation at high beam current 
(brightness full without bloom) before attempting purity 

or convergence adjustments. 


R18 Focus Adjustment 


R17 Brightness 
Adjustment 


Remove 3 Screws 
on each side to 
remove case. 


FOCUS AND BRIGHTNESS ADJUSTMENT LOCATION 


FIGURE 2.0.6.1 


Should any parts of the chassis become magnetized, it 
will be necessary to manually degauss the affected areas. 
Move a manual (GC 9317 or equivalent) degaussing coil 
slowly around those areas and the face of the CR Tube 
and slowly withdraw to a distance of six feet before 
disconnecting the coil from the AC power source. 


Before performing the purity adjustments, the center of 
the raster must be converged and the dynamic convergence 
set roughly as explained in Section 2.0.12. Check 

that the focus control is properly set (See Section 2.0.6). 
The focus adjustment should be made with the brightness 
control set at maximum beam current without bloom. 


1. Purity adjustments are most accurate while 
observing one screen only, preferably red. 
Erase the screen with the background color "RED". 


2. Loosen the yoke wing nuts and move the yoke to the 
rear as far as possible. (See Figure 2.0.7.1) 


3. Rotate the purity magnets and adjustment tabs so 
that a clean red area is produced at the center 
of the screen. Push the yoke forward until a 
uniform red raster is obtained. Tighten the 
yoke wing nuts. 


4, Erase the screen with the background color 
"WHITE". Check for a uniform white screen 
(see COLOR TEMPERATURE ADJUSTMENTS, Section 2.0.8, 
for procedure). If uniformity has not been 
obtained, reconverge the center of the screen 
and repeat the purity adjustments. 


5. It should be noted that purity adjustments also 
affect the focus and DC Horizontal and Vertical 
screen positions and these parameters may have to 
be readjusted as outlined under Sections 2.0.3, 
2.0 4), «and! 2.00 ¢ 
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BLUE 
LATERAL DEFLECTION 
ADJUSTMENT YOKE 
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BLUE ‘DEFLECTION 
LATERAL YOKE 
ADJUSTMENT HOUSING 


BLUE LATERAL 
MAGNET 
ASSEMBLY — 


CONVERGENGE 
PURITY YOKE 


ASSEMBLY DEFLECTION 
RINGS YOKE 


19" SCREEN 


YOKE; BLUE LATERAL, AND PURITY 
LOCATIONS AND ADJUSTMENTS 
FIGURE?" 2.0.7<4 
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COLOR TEMPERATURE ADJUSTMENTS 


1. Place a screen full of WHITE characters or ERASE 
the screen in WHITE. Turn the screen grid drive 
controls R14 (RED), R15 (GREEN), R16 (BLUE) (Analog 
Module 100047) to minimum drive (Fully CCW) then 
turn the BRIGHTNESS Control, R17 to maximum brightness 
(Fully CW). 


2. Turn the RED control, R14, clockwise until the red 
vertical retrace raster line at the top of the screens ‘° 
is just visible. Tur the GREEN Control, R15, clock. (Ib) 
wise until the grem vertical retrace raster line at 
the top of the screen is just visible. Repeat the 
same for the BLUE Control, R16.(R-i5) 


3. Adjust the BRIGHTNESS Control, R17, until there is 
no visible vertical retrace raster line and the 
brightness is at a comfortable viewing level with a 
minimum of color saturation. 


4. Adjust each screen grid drive control, RED (R14), 
GREEN (R15), and BLUE (R16), until a white screen 
is obtained, or a 9300°K color temperature (WHITE). 


TOP, BOTTOM, AND SIDE PINCUSHION ADJUSTMENT 


Place a suitable test pattern on the screen such as all 
'' (plus) symbols or all "." (periods). (See Section 
2.0.6 for pattern set-up). Any color or WHITE may be used. 


The top and bottom (Vertical) pin cushion adjustment is 
made, if necessary, by adjusting R5 on the Analog Module 
(100047) for straight horizontal lines at the top and 
bottom of the raster as shown in Figure 2.0.3.1 and 
Figure 2.0.9.1, 


The side (Horizontal) pin cushion adjustment is made by 
adjusting R7 on the Analog Module (100047) for straight 
vertical lines on the left and right side of the raster. 


Ve 


He 


GND 


Vertical 
Pincushions R/7/ 


Horizontal 
Pincushions R5 


PINCUSHION ADJUSTMENT 


FIGURE 2.0.9.1 


HORIZONTAL AND VERTICAL RAMP ADJUSTMENTS 
ANALOG MODULE (100047) 


FIGURE 2.0.10..1.1 


U11/6= Horizontal=R1l 


U10/6= Vertical=R2 
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CONVERGENCE ADJUSTMENT PRELIMINARIES 


The CONVERGENCE ADJUSTMENT PRELIMINARIES are necessary 
only if convergence cannot be obtained as outlined under 
FINAL CONVERGENCE ADJUSTMENTS (Section 2.0.12), or if 
these areas have required service or parts replacements, 
or the adjustment pots have been tampered with. An 
oscilloscope, such as the Tektronix 454, or equivalent 
will be necessary for these adjustments. 


PRELIMINARY HORIZONTAL RAMP ADJUSTMENT 


The Horizontal Ramp U11/6 amplitude is adjusted by Rl on 
the Analog Module (100047). The ramp is adjusted so 

that the positive peak is equal in height to the negative 
peak (symmetrical about ground or W = V-). (See 

Figure 2.0,10.1.1). 


PRELIMINARY VERTICAL RAMP ADJUSTMENT 


The VERTICAL RAMP U10/6 amplitude is adjusted by R2 on 
the Analog Module (100047) in the same manner as the 
HORIZONTAL RAMP ADJUSTMENT (See Figure 2.0.10.1.1). 


PRELIMINARY HORIZONTAL PARABOLA ADJUSTMENT (U7/3) 
RIGHT & LEFT CENTER, TUBE AREAS 4 & 5 (See Figure 2.0.12.2). 


Adjust R9 on the Analog Module (100047) until the bottom 
of the Parabola is at Ground level. See Figure 2.0.10.3.1. 


PRELIMINARY VERTICAL PARABOLA ADJUSTMENT (U8/3) 
TOP & BOTTOM CENTER, TUBE AREAS 2 & 3 (See Figure 2.0.12.2). 


Adjust R1O on the Analog Module (100047) until the bottom 
of the Parabola ts at srotnd level. See Figure 2.0.10.3.1. 


HORIZONTAL AND VERTICAL RAMP ADJUSTMENTS. 


Monitor the HORIZONTAL PARABOLA at U7/3 on the Analog 
Module (100047). Superimpose a small amount of the video 
signals (with a screen full of WHITE characters) by 
adding a small amount of the "B' trace (connect a scope 
probe to the collector of Q26 or Q27 or Q28) on the 
oscilloscope (CHOP, INVERT B, ADD) to the''A' trace 


(connected to U7/3). The above may also be accomplished 


220.1026 


2.05 10.7 


2.0510 ..8 


by simply connecting the "A" channel Scope ground to a 
etound in. the vicinity of O26, O27, oc Q28. The video 
will be apparent on the parabola, as shown in Figure 
ae 0 el U8 Ws oe Ie 


Adjust Rl until the superimposed video is as shown 
im FLewre 2.0.10.5.1. 


Monitor the VERTICAL PARABOLA at U8/3 and adjust R2 of 
the Analog Module (100047) until the end points of the 
parabola are equal in height. 


The above procedure is shown in Figure 2.0.10.5.2. 
VACANT 


CORNER PARABOLA ADJUSTMENTS 
TUBE AREAS 6, 7, 8, and 9 (See Figure 2.0.12.2) 


The CORNER PARABOLA ADJUSTMENTS are made by R11, R12 

and R13 on the Analog Module 100047 and monitoring the 
waveform as shown at U14/3 as in Figure 2.0.10.7.1. 

OFFSET is adjusted to zero by R13 by adjusting the 
waveform baseline to ground as shown in Figure 2.0.10./7.1, 
Waveform A. 


BASELINE SLANT is adjusted by R12 on Analog Module 
(100047) as shown in B of Figure 2.0.10.7.1. Adjust 
for Vgc equal to "0" volts. 


VERTICAL SYMMETRY is adjusted as shown in C of 
Fipure 2.0.10.7.1 using R11 on Analog Module (100047). 
Alignment is made by adjusting R11 until +Vic = “Vice 


HORIZONTAL, VERTICAL and CORNER PARABOLA TOUCH-UP 


Touch up of the HORIZONTAL, VERTICAL, and CORNER PARABOLAS 
can best be accomplished by monitoring the waveforms on 
the Jl on the Convergence Module (100014). 


A. Adjust the HORIZONTAL PARABOLA offset, Vup with R9 
on the Analog Module (100047) by monitoring the 
waveform at J1/1 on the Convergence Module (100014) 
as shown in Figure 2.0,10.0.1, A. 


B. Adjust the VERTICAL PARABOLA offset, V,,, with R10 on 
the Analog Module (100047) by monitoring the waveform 
at J1/5 on the Convergence Module (100014) as shown in 
Figure 2.0.10.8.1, B 


C. Adjust the CORNER PARABOLA offset, Vop with R13 on 
the Analog Module (100047) by monitoring the waveform 
at Jl/7 on the Convergence Module (100014) as shown 
in Pigure -2.0.1026. 1, €z 


E-14 


_ 


GND 


HORIZONTAL 
VERTICAL 


R2 
R1O 


HORIZONTAL AND VERTICAL PARABOLA ADJUSTMENTS 


FIGURE 2.0.10.3.1 


Adjust Rl (Analog Module, 
100047) to show 1 divi- 
sion difference between 
Start and Stop of Video. 


yy 


1 division 


ee 


Adjust Scope Gain 


to 6 divisions 
Superimposed 


Video 


HORIZONTAL PARABOLA VIDEO ADJUSTMENT 
PLGURE: 2,010 75.1 


VERTICAL PARABOLA HEIGHT ADJUSTMENTS 


FIGURE 2.0.10.5.2 


using R2 on 
Analog Module 
(100047) 


GND 


A. CORNER PARABOLA OFFSET 


Typical 


B. CORNER PARABOLA BASELINE SLANT 


peeriiiiitt 


L. 


Zs 


all GND 


Adjust R13, Analog Module 
(100047) to Voc = Oe 
Volts offset. 


. Monitor Waveform at U14/3 


on Analog Module (100047) 


1. Adjust R12 Analog Module 


(100047) to Vcc = "oO" 
VOLES: 


Monitor waveform at U14/3 
on Analog Module (100047) 


. Adjust R11 Analog Module 


(100047) to +Vyc = -VHC 


. Monitor waveform at U14/3 


on Analog Module (100047) 


CORNER PARABOLA ADJUSTMENTS 


FIGURE 2.0.10.7.1 
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Adjust R9 on 
Analog Module 
(100047) until 
Vyp = "0" Volts 


HORIZONTAL PARABOLA 
J1/1 ON CONVERGENCE MODULE (100014) 


A, 


Adjust R10 on 
Analog Module 
(100047) until 
Vyp = "0" Volts 


VyP 


a 


VERTICAL PARABOLA 
J1/5 ON CONVERGENCE MODULE (100014) 


B. 
Adjust R13 on Analog Module 


"0" Mio Les 


Vcp 


CORNER PARABOLA 
J1/7 ON CONVERGENCE MODULE (100014) 
C. 


HORIZONTAL, VERTICAL, AND CORNER PARABOLA TOUCH-UP 


FIGURE 2.0.10.8.1 
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20 CONVERGENCE STATIC ADJUSTMENTS 


Place a dot pattern on the screen in the following 
manner from the Keyboard. 


Define FOREGROUND COLOR AS "WHITE" 
BACKGROUND COLOR AS "BLACK" 
Depress ''.'' (period) Key and allow to repeat 
until the screen is full of white dots. 


The above will fill up the screen with dots. Now 
place "+" symbols utilizing the keyboard as shown 
in Figure 2.0. 11.1 


Turn all the pots on the Convergence Module (100014) to 
the straight up position as shown in Figure 2.0.11.3. 


Now adjust the static magnets and the Blue Lateral Magnet 
to align the ''+'' symbols R,G,B, colors in Screen Sector 1, 
as shown in Figure 2.0.11.2, so as to appear as "WHITE". 
This will occur when the RED, GREEN, AND BLUE colors are 
accurately superimposed on top of each other. With the 
exception of BLUE lateral which is explained below. 


For the above to be accurate the tube must have been 
externally degaused, the Purity adjusted, the FOCUS R18 
adjusted for sharp, and the BRIGHTNESS, R17, Analog 
Module (100047), set for a low level with the color 
temperature being set to 9600°K as explained in previous 
sections. DO NOT ATTEMPT FURTHER CONVERGENCE UNLESS THE 
ABOVE HAS BEEN PREVIOUSLY PERFORMED. (See Sections 


The beams move at approximately the same angle as the 
convergence magnets are offset from the vertical plane. 
Blue, since it is mounted in the vertical plane moves 


. . . + . . . . . . ° 


CONVERGENCE TEST PATTERN 


FIGURE 2.0.11.1 


the beam up and down vertically; red and green move the 
respective beams on a line at about a 60° angle from the 
vertical. The blue lateral magnet moves all three beams 
in the horizontal plane, the blue beam in one direction 
and the red and green beams in the opposite direction in 
a 5 to 1 ratio. The blue beam has the greatest lateral 
Shift. 


The thumb screw adjustment of red, green, and blue center 
convergence magnets can be rotated in either direction 
continuously. Flux change is accomplished by rotating 
the pole position of the magnets, not by moving the 
magnets farther from or closer to the respective guns. 


Adjust the Static Blue so that the Blue in the center of 
the screen is superimposed on the RED and GREEN. 


20 c12 FINAL CONVERGENCE 


Touch up the center convergence with the pots R13 (GREEN), 
R14 (RED) and R15 (BLUE) on the Convergence Module (100014) 
as shown 1p Pipure 2.0: 1122 and Fiscure 2.0 .11.3. 


Once center convergence has been adjusted proceed to the 
next convergence Screen Sector, 2, as shown in Figure 2.0.11.2. 
Proceed with the alignment in the order of the sector numbers 
as shown in Figure 2.0.11.2. After each Sector is aligned, 
check and touch up the center convergence. Note that 

the adjustment pots on the Convergence Module (100014) are 
arranged in the same location as each Screen Sector as 
viewed on the tube face (and the component side of the 

board) and the trio of pot groups in each sector are 
arranged as GREEN, RED, AND BLUE corresponding to the 
location of the GREEN, RED, and BLUE electron beams as 
viewed from the tube face. 


When completed with the above, touch up each Screen Sector 
as needed in the SAME ORDER as outlined above. Do not 
violate the order of the Screen Sector numbers in the 
adjustment procedure. 


Never attempt a convergence procedure without first setting 
the Convergence Module (100014) pots to the center position 
as shown in Figure 2.0.12.3 and following the Screen Sector 
numbers. It is seldom necessary for the static magnets to 
be adjusted unless shipment vibration causes convergence 
coil or static magnet movements or unless convergence coil 
or yoke replacements become necessary. 
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CR TUBE CONVERGENCE SECTORS (SCREEN VIEW) 
FIGURE 2.0.12 ,2 


CONVERGENCE BOARD ASSEMBLY SHOWING 
CONTROLS ASSOCIATED WITH TUBE SECTORS 
(TOP VIEW) 
NOTE: Green and Red Pots are interchanged on all 17" Tubes. 
FIGURE -2.0.12.3 


The CPU 
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--TERMS AND ABBREVIATIONS-- 


TERMS: 


TERM DESCRIPTION 


Address A 16 bit number assigned to a memory location 
corresponding to its sequential position. 


Bit The smallest unit of information which can 
be represented. (A bit may be in one of 
two states, Oor 1). 


Byte A group of 8 contiguous bits occupying a 
Single memory location. 


Console Refers to the 8001 CRT Display as the 
output device, and the 8001 keyboard 
as the input device. Allows operator 
interface with the CPU operating system. 


Instruction The smallest single operation that the 
computer can be directed to execute. 


Object Program A program which can be loaded directly into 
the computer's memory and which requires no 
alteration before execution. An object 
program is usually on paper tape, and is 
produced by assembling (or compiling) a 
source program. Instructions are re- 
presented by binary machine code in an 
object program. 


Program A sequence of instructions which, taken as 
a group, allow the computer to accomplish a 
desired task. 


Source Program A progam which is readable by a programmer 
but which must be transformed into object 
program format before it can be loaded into 
the computer and executed. Instructions in 
an assembly language source program are 
represented by their assembly language 
mnemonic. 


System Program A program written to help in the process of 
creating user programs. 


TERMS -- (Continued): 


TERM 


User Program 


STARTING ADDRESS - 


DESCRIPTION 


A program written by the user to make the 
computer perform any desired task. 


100 When in 8708 ERASABLE PROM 


Word A group of 16 contiguous bits occupying 
two successive memory locations. (2 bytes). 
ABBREVIATIONS: 
ABBREVIATION DESCRIPTION 
Cr Carriage return 
CPU Central Processing Unit 
Lf Line feed 
PROM Programmable Read Only Memory 
Sp Space Bar 
nnn B nnn represents a number in binary format. 
nnn D nnn represents a number in decimal format. 
nnn O nnn represents a number in octal format. 
nnn Q nnn represents a number in octal format. 
nnn H nnn represents a number in hexadecimal format. 
Shaded portions of CPU/operator dialog repre- 
sent Console output. 
CPU O.S. COMMANDS AND MESSAGES 
2.0 CPU OPERATING SYSTEM (0.S.) 


2" 


U-stARTS AT EOOO, PAUSES AT FFF EH 
we-Pt 
Ol-P2. 
@2-03 
All arguments are in hexadecimal form. 


A RAM Test 2,3,4° 


B GO BACK TO CRT O.S. 


D DISPLAY IN HEXADECIMAL FORMAT 
D low address, high address 


Memory from low address to high address is displayed in hexadecimal 
form. 


E END 

E address 

Endfile mark is created; 60 null characters are written on 
punch device 

F FILL MEMORY 

F low address, high address, data 


Memory from low address to high address is filled with data. 


G GO TO 

G Address, bkptl, bkpt2 

Program control is transferred to address. Breakpoints are set at 
bkptl and bkpt2. When break points are executed, all of the CPU 
registers are automatically displayed. 

H HEXADECIMAL ARITHMETIC 


H number, number sp 


The sum and difference of the two numbers is printed in hexadecimal. 


L LOAD HEXADECIMAL TAPE 
L Bias address 


A hexadecimal format tape is read into memory at tape address plus 
bias address. 


M MOVE 

M low address, high address, destination address 

A block of memory from low address to high address is moved 
to location destination address. 

N PUNCH NULL 

N 


Sixty null characters are punched. 


R BAUD RATE FOR SECOND RS-232 CHANNEL 

R rate number 

The rate number must be between 1 and 7. See the "How to Use the 8001" 
Manual. 

Ss SUBSTITUTE 

S address Sp 

Memory at address is displayed, and can be modified by typing 
in new data. Termination with space opens next sequential 
address, termination with carriage return ends command. 

».4 EXAMINE REGISTERS OR MEMORY 

X reg ident 


Register is displayed, and can be modified as in the S command. 


W WRITE HEXADECIMAL 
W low address, high address 


Memory from low address to high address is punched in hexadecimal 
format. 


MESSAGES 
: CPU O.S. ready to accept commands 
? Error. Reenter command 


3.30 INTECOLOR® 8001 CONFIGURATION 


ile I/O SYSTEM 


The Intecolor® 3001 can support a number of input/output devices, 

from the CRT display and the RS232C I/O to devices supplied by 

the user. In general, it may be convenient to have two devices 

which can perform the same function, but to use them for different 
purposes at various times. For example, if a program is being assembled, 
you might want the program listing to be written on one device, while 
any system messages not relevant to the assembly would be written ona 
separate device. 


The I.0 system described below permits this type of change. Devices 
may be assigned functions via the System Monitor S command (see Section 
4.2.11) or via the user's program. That is, it is possible to write 
programs which read from several different input devices and write to 
several different output devices of the program's choosing, without re- 
quiring any human intervention. 


Sirol are LOGICAL AND PHYSICAL DEVICES 


Regardless of how many I/O devices a particular Intecolor® 8001 

has, there are only four operations which can be performed to 

any of them. For example, a WRITE operation can be performed 

either to the RS232C channel 1 to a host computer or a high speed 

tape system. All system programs and user-written programs, therefore, 
access four LOGICAL DEVICES (i.e., a WRITE device) which are then trans- 
lated to a PHYSICAL DEVICE (i.e., a high speed tape) by the I/O 

system. 


The four logical devices available to programs are: 


CONSOLE An interactive, character-oriented device used 
for both input and output. 


READER A character-oriented, input-only device which 
transfers data on command and signals the 
program when where is no more data (an end-of- 
file condition). 


WRITE A character-oriented, output-only device which 
accepts a character from the program and re- 
cords it on some external medium. 


LIST A character-oriented, output-only device which 
accepts a character from the program and records 
it on some external medium in human readable form. 


AFIO = -24688 


Each of these four logical devices may be associated with one of 
four physical devices at any instant, giving a total of 16 phys- 
ical devices. The mapping from logical to physical devices is 
specified by an I/O status byte which resides in memory and is 
accessible to system and user programs via substitute command. 

The address of the I/O status byte is 9F9Z hex. A pointer to 

the I/O status byte is also contained in memory locations %%36 

and @Z37 (low byte of pointer, high byte of pointer). The possible 
mappings appear as follows: 


I/O Status Byte: 


Initially 
AJA; = LIST FIELD AyAg= CONSOLE FIELD 
AcA, = PUNCH FIELD A,A5= READER FIELD 
LOGICAL DEVICES I/O DEV FIELD PHYSICAL DEVICES 


RS232 Channel 1 
RS232 Channel 2 


CONSOLE CR Tube = Console Output 
Keyboard= Console Input 


(user console device) 


RS232 Channel 1 


RS232 Channel 2 


Keyboard 


(user reader device 1) 


LOGICAL DEVICES I/O DEV FIELD PHYSICAL DEVICES 
RS232 Channel 1 
RS232 Channel 2 


CR Tube 


(user punch device 1) 


RS232 Channel 1 
RS232 Channel 2 
CR Tube 


(user list device 1) 


At cold start or system reset, the I/O status byte is set equal 
to 82H, causing the CR Tube and keyboard to be selected for console 


I/O and LIST, while the RS232 Channel 1 is selected for both READ 
and WRITE. 


Biedes2 I/O SUBROUTINES 


The way in which a program performs an I/O operation to any of 
the four logical devices is by calling the appropriate sub- 

routine supplied by the I/O system. The available subroutines 
and their locations in memory are given in the following table: 


ROUTINE FUNCTION MEMORY LOCATION 
CI Console input 103H 
CO Console Output 109H 
RI Reader input 106H 
PO Punch output 10CH 
LO List output 10FH 
S{@) Console String Output 12AH 


The rest of this section gives a description and examples of 
how to call these subroutines. 


CI - CONSOLE INPUT 
This routine returns a character received from the selected 


console device to the caller in the A register. The A regis- 
ter and the condition bits are affected by this operation. 


Example: 


Assembly Language 


CO - CONSOLE OUTPUT 

CO transmits a character, passed from the calling program in 
the A register, to the device selected for console output. The 
A register and the condition bits are affected. 


Example: 


Assembly Language 


CALL CO ;PRINT '.' ON CONSOLE 


RI - READER INPUT 


RI returns a character read from the reader device in “the A 
register. If no character was read from the device (i.e., 

end of file), the CARRY condition bit is set equal to 1, and 
the A register is zeroed. If data is ready, the CARRY bit is 
zeroed. If no character is received from the physical device 
then striking any key causes an end of file to be simulated and 
control is returned to the calling program. 


Example: 


Assembly Language 


CALL RI 
JC EOF ; END OF FILE SENSED 
STA DATA 


PO - WRITE OUTPUT 


PO transmits a character from the calling program to the device 
selected as the punch device. PO is identical in format to CO. 


LO - LIST OUTPUT 


LO performs the same function to the selected list device as 
CO and PO do to their selected devices. 


SO - CONSOLE STRING OUTPUT 


SO transmits a character string to the device selected for console 
output. A pointer to the beginning of the string is passed from 
the calling program in the HL register pair. The string should be 
terminated by a byte having the value 239 (decimal). SO also pro- 
vides repeat loops of the form: ware ooh ING Dal, D240 Gist pn DM, (2318, 
--. where N is the repeat count for the string of bytes Dl 
through DM. 


Example: 
Assembly Language 


LXI H, STR 
CALL SO 


STR: (DB “ABS; 237, 3, "CD"; 238, "ERG" ,.239 


This example will print 'ABCDCDCDEFG' on the console device. 


FLOPPY TAPE I/O SUBROUTINES 


Three I/O subroutines are provided for the Intecolor Floppy Tape. 
These routines are: 


ROUTINE FUNCTION MEMORY LOCATION 

TWR Write to Floppy Tape faze CGeEHH 
TRD Read from Floppy Tape P33 68Q5H 
TVF Compare memory with Floppy Tape -6t36H- eS POr 


The Floppy Tape is a block-transfer device. One record is written 
per track. The inputs from the calling program to each of the 
three I/O routines are: 


HL register pair - pointer to memory buffer 


DE register pair - byte count 


A register - Tape drive/track code: 
BIT3 - DRIVE: @ or l 
BITS2-6 - Track: through 7 


After calling any one of the routines, the A register will contain a 
status code and will have been tested (ORA A): 


A=6 : No Errors 

A=2 Keyboard Abort (Pressing any key on the 
keyboard during the data transfer will 
abort the operation) 

A=4 : Buffer too large for write. 

A=6 ; Buffer too small for read. 

A=8 : Read Failure: A complete, correctly 
formatted record could not be read 
from the tape. 

A=10 R Checksum error. 

A=12 : Verify failure. A mismatch was detected between 


data in memory and data read from the tape 
during a memory compare operation (TVF). 


Also, after calling any of the routines, the HL register pair 
will point one byte past the last byte manipulated in the memory 
buffer. 


3.1.3 USER-SUPPLIED DEVICES 


This section describes the necessary steps in hooking up a 
user-supplied I/O device to the I/O system. 


The I/O subroutines described in Section 3.3.2 assume that 
programs (called drivers) exist which perform the actual 
transfer of data between I/O devices and the CPU. For in- 
stance, when the console input routine is called, it checks 
to see which physical device is assigned to the console, 
and then branches to the driver appropriate to the device 
Therefore, when the user supplies his own device, he must: 


1) Write a program to perform the data transfer, 
making sure that the program saves and restores 
any CPU registers it uses that are not specifi- 
cally changed by the I/O subroutine. 


10 


2) Store a JMP to this driver's address in the 
appropriate location as defined in the 
following table: 


MEMORY LOCATION USE 
9F91H USER DEFINED CONSOLE INPUT 
9F 94H USER DEFINED CONSOLE OUTPUT 
9F97H USER DEFINED READER (1) 
9F 9AH USER DEFINED WRITE (1) 
9F 9DH USER DEFINED LIST (1) 


Thus, if the user supplied a custom built listing device, he would 
write a driver to transfer data to it in an appropriate manner, 
then store the JMP to the driver's address at location 9F9DH. By 
assigning LIST=3, his device would receive any listing output 
generated. 


4.0 CPU OPERATING SYSTEM 


The Intecolor 8001 CPU O.S. enables the operator to easily 
manipulate the contents of memory, 
@apess. and execute programs. 


The CPU O.S., and all Intecolor® 8001 system software in 

general, use the last 80 memory locations after the refresh 
area for storage of temporary data. Therefore, if the opera- 
tor runs a program beginning in these locations, and then uses 
the CPU O.S. Text Editor, or Assembler, he must re-load these 
80 bytes of his program before running it again. Alternatively, 
programs could be written beginning at any higher location. 

Then system programs and user programs could be executed in 

any order, without requiring the re-load operation. 


For a 25 line system these locations are 8FBOH to 8FFFH. 
The 48 line system uses locations 9FBOH to 9FFFH. 


The CPU O.S. is the operator's interface to the 8080 CPU, and 
controls loading and execution of user programs, and to some 
extent the debugging of user programs. Figure 4-1 illustrates 
memory utilization during various stages of system software 
use. While the CPU O.S. is running, it uses an area at the 
top of memory for data storage and scratch work. 


nl 


4.1 CPU OPERATING SYSTEM IMPLEMENTATION AND EXECUTION 


4.1.1 CPU O.S. IMPLEMENTATION 


The Intecolor’ 8001 CPU O.S. program is implemented on two 

E PROM modules, which are pre-installed into each Intecolor 8001 
with Option 34. This allows the CPU to be used with great 

ease, as it is not necessary to wait for lengthy paper-tape 
loading operations. All that is required to go on-line with 

CPU O.S. is to turn the Intecolor 8001 on, hit the ESCAPE 

key, and then the CPU O.S. key, and begin execution. 


4.1.2. STARTING SYSTEM MONITOR 


To begin operating the CPU 0.S., press two keys in sequence, 
"ESCAPE', (CPU O.S.) and the Intecolor 8001 will automatically 
jump to the starting address of the CPU O.S. 


4.2 CPU O.S. OPERATION AND COMMANDS 


The commands consist of a single letter typed into the 
Intecolor® 8001 keyboard followed by a number of arguments, 
possibly none. The arguments are separated, if there are 
more than one, by spaces or commas. A command is terminated 
and executed by typing a carriage return or space, depending 
upon the command. 


A (Ram TEST 2,34 ?) Jy is v isual | 


4.2.1 B COMMAND (BACK TO CRT O.S.) 


4.2.2 D COMMAND (DISPLAY DATA) 


The format of the D command is: 
D low address, high address 


Low address is a valid 16 bit memory address. 
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High address is a valid 16 bit memory address equal to or 
greater than low address. 


Description: Upon execution of this command, memory data 
from (low address) to (high address) is displayed upon the 
list device (normally the CR tube). Data are displayed in 
hexadecimal form. Up to sixteen bytes per line are printed, 
preceded by the hexadecimal address of the first byte of 

that line. A carriage return is forced after a byte having a 
low order digit of F in its memory address is printed. 


Example: Enter at the keyboard the command: 
-DLOF, 123 (Cr) 
and the CR Tube will display: 
O10F AA 
0110 BB CC DD EE FF 11 22 33 44 55 66 77 88 99 AB CD 
0120 EF 12 34 56 


where memory locations OlOF through 0123 are assumed to contain 


AA BB CC DD EE FF ll 22 33 44 55 66 77 88 99 AB CD EF 
12 34 56 


the D command should be used only to examine memory contents. To 
punch the memory contents onto a tape, the W command should be 
used. These commands produce a tape in the proper formats, while 
the D command causes a simple sequence of characters to be 
output. 
Error conditions: 
als If low address or high address is greater than 16 bits, 
only the last 4 hex digits of the argument will be used 
as the address. 
Example: The command 
-D30010,AB0013 (Cr) 
is equivalent to the command 
-DO010,0013 (Cr) 


2: If low address is greater than high address, only the 
one byte at low address will be displayed. 


- 
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Example: The command: 


-D10,6 
is equivalent to the command 
-D10,10 
3% Non-existent memory is equivalent to a string of bytes 


all containing FF H. 


Example: If memory address 2000 H- 2010 H are invalid, then 
the command: 


-D2000, 2010 
will cause the teletype to print: 
2000 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 


2010 FF 


4. If low address or high address contains an invalid 
character, or if high address is omitted, the CR Tube 
will immediately display '?(Cr) (l1f). and await the 
next command. 


Example: If the user attempts to enter the number OG as an 
address, the following will be displayed: 


- DOG? 


4.2.3 F COMMAND (FILL MEMORY WITH CONSTANT) 


The format of the F command is: 
F low address, high address, data 
Low address is a valid 16 bit memory address. 


High address is a valid 16 bit memory address equal to or 
greater than low address. 


Data is an 8 bit data value. 
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Description: Execution of this command causes memory locations 
(low address) through (high address) to be filled with the 
constant (data). 
Example: The command: 

-F7,14,AA (Cr) 


will set bytes 0007 through 0014 equal to AA H. 


0007 AA AA AA AA AA AA AA AA AA 
0010 AA AA AA AA AA 


i 
Error Conditions: 
ile If low address of high address is greater than 16 bits 
(or data is greater than 8 bits), only the last 4 (or 2) 
hex digits will be used. 
Example: The command: 
- F7AB0007, 0014, FFACAA (Cr) 
is equivalent to the command: 
-F0007,0014,AA (Cr) 
2. If low address is greater than high address, data will 


replace only the byte at low address. 


Example: If locations 7, 8, and 9 contain AA H, BB H, and CC H, 
execution of the command: 


«P71; 33(Cr) 
will cause memory to appear as follows: 


0007 33 BB CC 


she If a non-existent memory address is specified, this 
command has no effect. 


4s If low address, high address, or data contain an invalid 


character, the CR Tube will immediately display '? (Cr) (1f).' 


and await the next command. 


Example: If the user tries to enter BQ as data, the following 
will be displayed: 


.F0012,14,BQ? 
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4.2.4 G COMMAND (GO TO) 


The format of the G command is: 
G address, bkptl, bkpt2 


Address, bkptl, and bkpt2 are valid 16 bit hexadecimal memory 
addresses. 


Description: The G command causes program control to be trans- 
ferred to location address. If either bkptl or bkpt2 is specified, 
a breakpoint will be set in the program at the corresponding 
address(es). The specified address must correspond to the first 
byte of a program instruction. If either breakpoint is en- 
countered during program execution, the CPU O.S. will save and 
display all program status (CPU registers and condition bits), 
clear all existing breakpoints, and take control. The user may 
then examine and/or modify registers or memory, or use any other 
monitor commands. This feature allows the user to debug por- 
tions of a program. 


If address is not specified, the program status is restored 
and the saved value of the program counter is used as the new 
starting address. 

Example: The command: 


G24A 


will cause program execution to begin at location 24AH, with 
no breakpoints being set. 


The command: 

G, L2€ 
will cause a breakpoint to be set at 12CH, and program execution 
to resume at the address indicated by the saved value of the 
program counter. 
The command: 

G 
will cause program execution to resume at the address indicated 


by the saved value of the program counter, with all status 
restored and no breakpoints set. 
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Error Conditions: 


i. If address is greater than 16 bits, only the last 4 
hex digits of the argument will be used as the address. 


Example: The command: 


-G3C0010 (Cr) 
is equivalent to the command 
-GO010 (Cr) 
25 If address is a non-existent memory address, the system 


will attempt to transfer control and then return to the 
CRT O.S. with no response. The CPU O.S. must then be 
manually restarted. 


4.2.5. H COMMAND (HEXADECIMAL ARITHMETIC) 


The format of the H command is: 
-H number, number Sp 
Number is a 16 bit hexadecimal number. 


Description: The H command is designed to aid the user in 
performing hexadecimal arithmetic while using the CPU O.S. 

It causes the sum and difference it arguments to be displayed 
in two-s complement hexadecimal form. This command is termi- 
nated by a space, rather than by a carriage return. 


Example: 
-H1E,5C OO7A FFC2 
Error Conditions: 
La If either number is greater than 16 bits, only the last 


4 hex digits are used. 
Example: The command: 
. HOOABC, 23Sp 
is equivalent to the command: 


.HOABC, 23Sp 
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Ds If number contains an invalid character, the CR Tube 
will immediately display '?(Cr) (1f).' and await the 
next command. 


Example: If the user attempts to enter O1P, the following will 
be displayed: 


-HO1P? 


4.2.6 I COMMAND (RESET CRT TO STATE So) 


The format of the I command is: 


I causes the same action as the CPU reset key 
being typed. 


4.2.7 L COMMAND (LOAD HEXADECIMAL FILE) 


The format for the L command is: 


L bias address 


Bias Address is a 16 bit two's complement hexadecimal number. 


Description: This command loads tape written in hexadecimal 
format (using the W command) into memory. The address at which 
the tape is loaded is determined by adding the address on the 
tape to the bias address using two's complement arithmetic. 

The bias may be negative, but in this case must be in two's 
complement form. If the tape was produced using an E command 
with a non-zero entry point address (see section 4.2.11), 
control will be transferred to that location in memory. Other- 
wise, the CPU O.S. will remain in control and request another 
command. 


Example: If a tape was used which began at location 0100 H, 
the following command: 


. LFFBO (Cr) 


will cause the tape to be read and loaded into location 50 H. 
(1000+FFBO=50) . 
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NOTE : If an error occurs while reading the tape (such as a 
checksum error), the CPU O.S. will immediately stop reading 

the tape, display '?(Cr) (Lf).' and await the next command. 

The operation may be retried by backing up the tape to any 
point before the last colon and issuing another L command, 
since each data word specifies the address at which it is to be 
loaded. The CPU O.S. will read up to the first colon it en- 
counters, and then begin loading data. 


Note that this means that, if you wish to change data in 
locations in memory, it is not necessary to regenerate an 
entirely new tape with the change; instead you may read in 
the original tape, then read in a patch tape which reloads 
only the erroneous locations. 


Error Conditions: 


A If the bias address is greater than 16 bits, only the 
last 4 hex digits are used as the bias address. 


Example: The command: 
-LOOFFBO (Cr) 


is equivalent to the command: 


-LFFBO (Cr) 
2. If an invalid character is present in the bias address, 
the CR Tube will immediately display '*(Cr) (If).' and 


await the next command. 


Example: If the user attempts to enter GOO as a bias address, 
the following will be displayed: 


-RG? 


4.2.8 M COMMAND (MOVE MEMORY) 


The format of the M command is: 


-M low address, high address, 
destination address 


Low address is a valid 16 bit memory address. 


High address is a valid 16 bit memory address equal to or 
greater than low address. 
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Destination address is a valid 16 bit memory address. 
Description: The M command causes the block of memory from 
low address through high address to be moved to the locations 
in memory beginning at destination address. 


Example: If memory appears as follows: 


LOCATIONS DATA 


0300-0304 contain 01020304 
0200-0204 contain Al1A2A3A4 


Then the command: 
M200,204,300 
will cause the following: 


LOCATIONS DATA 


0300-0304 contain A1A2A 3A4 
0200-0204 contain A1lA2A3A4 


Note: The movement is performed byte by byte: the byte at 

low address is moved to destination address, then low address 

+1 is moved to destination address+l, etc. Therefore, the 

MOVE command may be used to fill memory with a byte or sequence 

of bytes. 

Example: If location 0300 H contains FF H, the command 
-M300, 310, 301 (Cr) 

will cause locations 300 through 310 to contain FF H. The FF 

at 300 is moved to 301, then the byte at 301 (which is now FF), 

is moved to 302, and so on. 


Error Conditions: 


al If any address is greater than 16 bits, only the 
last 4 hex digits are used as the address. 


Example: The command: 
-M00302,303,00405 (Cr) 
is equivalent to the command: 


M302,303,405 (Cr) 
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2 If low address is greater than high address, only 
one byte will be moved from low address to destina- 
tion address. 
Example: The command: 
-M300,2F0,100 (Cr) 
is equivalent to the command: 
-M300,300,100(Cr) 
35 If low address through high address specifies a non- 
existent range of memory, bytes of FF H will be moved 


to the memory locations specified by destination address. 


Example: If locations 2000 H through 2005 are non-existent, 
the commend: 


- M2000, 2005,100(Cr) 


will cause locations 0100 H through 0105 H to contain FF H. 


4. If an invalid character is entered in an address, the 
CR Tube will display '?(Cr) (1f).' and await the next 
command. 


Example: If the user attempts to enter OBAG as the destination 
address, the following will be displayed: 


M100, 10F , OBAG* 


Ae 2.39 R COMMAND (BAUD RATE SELECT) 
The format of the R command is 
R rate value 


The rate value must be between 1 and 7. See chart below. 


NUMBER 


NORMAL BAUD 1200! 2400 | 4800 | 9600 
RATE 


HIGH SPEED 19,200] 38,400|76,800 
BAUD RATE 
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4.2.10 S COMMAND (SUBSTITUTE MEMORY) 


The S command is used to display and/or modify the contents 
of individual memory locations. It is used as follows: 


1. Type an S, followed by the hexadecimal address of the 
first memory location you wish to display. Type space. 


Qs The data from the selected address is displayed, 
followed by a dash (-). 


Bi To modify memory, type in the new data followed by a 
Space or a carriage’*return. If you do not wish to 
modify the contents of that location, do not type any 
data in, but only type-a space or carriage return. 


4. If a space was typed in step 3, the next memory 
location will be displayed as in step 2. Ifa 
carriage return was typed, operation will be returned 
to the <cBU O.S: 


Example: The contents of the first four bytes of memory is 
00 Al CE FF. You wish to change it to 00 A3 CE ll. 
-SOOOOSpOOSp Al - A3Sp CE - Sp FF - 11Cr 


User entries are unshaded. Display back is shaded. 


Error Conditions: 


di; If address is greater than 16 bits, or the data to be 
substituted is greater than 8 bits, only the last 4 
or 2 hex digits respectively are used. 


Example: The following sequence is equilvalent to the previous 
example: 


.SOABOOO0Sp 00 - Sp Al - BA3Sp CE - Sp FF - O1l1Cr 


23 If an invalid character is encountered, the CR Tube will 
immediately display '?(Cr) (1f).' and await the next 
command. 
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4.2.11 X COMMAND (EXAMINE AND MODIFY REGISTERS) 


The format of the X command is: 


X reg ident 
X GR) PRINTS ALL REGISTERS , ANNOTATED F 
Reg ident is a single character specifying a CPU register as 
follows: 


register 

register 

register 

register 

E register 

= Flag byte, displayed in the form as it is stored 
by the instruction PUSH PSW 

= H register 

= L register 

H and L registers combined (16 bits) 

= Program counter (16 bits) 

= Stack pointer (16 bits) 


It 
UAW Pp 


i] 


yHovodauwp 
i] 


NUE 
i 


Note: The format of the flag byte F is: 


A 
SZ 0°C. 0) P= Le 


Sign bit State of carry bit 
Zero bit Always 1 

Always 0 State of parity bit 
Auxiliary carry bit Always 0 


Description: The X command is used to display and/or modify 
CPU registers. It operates similar to the S command, as follows: 


1. Type an X, followed by the register identifier. 
2 The data from the selected register is displayed, 
followed by a dash (-). Four hexadecimal digits 


are displayed for M, P, and S; two hex digits for 
the other register identifiers. 


oe To modify the register, type in the new data followed 
by a space or a carriage return. If you do not wish 
to modify the register, type only the space or carriage 
return. 
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4. If a space was typed in step 3, the next register in al- 
phabetical order is displayed. If carriage return was 
typed, the X command is terminated. If a space is typed 
after register S has been displayed, the command is terminated, 
this being the last register identifier in the list. 


Example: The A, B, C, and D registers contain AAH, BBH, CCH, 
and DDH, respectively. You wish to change the B and C registers 
to OOH and FFh, respectively. 


XASp AA- Sp BB- OOSp CC- FFSp DD-Cr 


Note: Values set by the X-command will become the actual 
contents of the registers after execution of the next GO 
command. 


The values displayed by the X-command are the contents of 
the registers prior to the execution of the last breakpoint 
set by the GO command. These displayed values, however, 
will reflect any changes of register "contents" made by the 
execution of X-commands since this last breakpoint. 


Error Conditions: 


ag If the data to be substituted is greater than 16 
bits for registers M, P, S, or 8 bits for the other 
register identifiers, only the last 4 or 2 hex 
digits respectively are used. 


2% If an invalid register identifier or character is 
encountered, the CR Tube will immediately display 
'2(Cr) (Lf£).' and await the next command. 


4.2.12 E COMMAND (END FILE) 


The format of the E command is: 
E address 
Address is a valid 16 bit memory address. 


Description: The E command causes an end-of-file mark and 
sixty null characters to be written at the end of a hexa- 
decimal output file. The end of file mark is hexadecimal 
record of length 00. (See Appendix D). If address is 0 

or absent, the L command which loads the file will return 
control to the CPU O.S. If address is non-zero, the L command 
will transfer control to that memory address immediately after 
loading the file. 
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; be 
4.2.13 W COMMAND (WRITE MEMORY) drive oc the Track ig Ld nl 


The format of the W command is: 
W low address; high address 
Low address is a valid 16 bit memory address. 


High address is a valid 16 bit memory address equal to or 
greater than low address. 


Description: The W command is used to output memory locations 
low address through high address to the system punch device 

in hexadecimal format. A series of W commands may be issued 

in order to punch various non-contiguous memory locations onto 

a continuous strip of tape. 

Any series of W commands should be terminated with an E command 
in order to punch a termination character, so that when the tape 


is read it will be handled properly. 


Example: If memory locations 1 through 3 contain 53F8EC, the 
command: .W0O001,0003 (Cr) 


produces: 
:0300010053F8ECC5 


(See Appendix D for an explanation of tape format.) 


Error Conditions: 
aL If low address or high address is greater than 16 
bits, only the last 4 hex digits of the argument 
will be used as the address. 
Example: The command: 
WABOO10,100 (Cr) 
is equivalent to the command: 
w0010,100(Cr) 


2 If low address is greater than high address, only 
the one byte at low address will be written: 
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Example: The command: 


-W10,0(Cr) 
is equivalent to the command: 
-W10,10(Cr) 
3. Non-existent memory is equivalent to a string of 


bytes all containing FF H. 


4. An invalid character in either address will cause 
the CR Tube to display '?(Cr) (1f).' and await the 
next command. 


Example: If the user attempts to enter 3Z as low address, 
the following will be displayed: 


-W3Z? 


4.2.14 N COMMAND (NULL PUNCH) 


The N command consists only of the letter N followed by a 
carriage return and causes 60 null characters to be written 
on the punch device. 
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APPENDIX A 


-- INSTRUCTION SUMMARY -- 


This appendix provides a summary of 8080 assembly language 


instructions. 


A 


An 


ADDR 

Aux. carry 
Carry 

CODE 

DATA 
DATA16 

DST 

EXP 


INTE 


Abbreviations used are as follows: 
The accumulator (register A) 


Bit n of the accumulator contents, where n may have any value 
from 0 to 7 and O is the least significant (rightmost) bit. 


Any memory address 
The auxiliary carry bit 
The carry bit 
An operation code 
8 bits (one byte) of data 
16 bits (2 bytes) of data 
Destination register or memory byte 
A constant or mathematical expression 
The 8080 interrupt enable flip-flop 
Any instruction label 
A memory byte 
The parity bit 
Program Counter 
The most significant 8 bits of the program counter 
The least significant 8 bits of the program counter 
Any register or memory byte 
A register pair. Legal register pair symbols are: 
B for registers B and C 
D for registers D and E 
H for registers H and L 


SP for the 16 bit stack pointer 
PSW for condition bits and register A 


Wag 


( ) 


Format: 


The first register of register pair RP 

The second register of register pair RP 

The sign bit 

The 16-bit stack pointer register 

Source register or memory byte 

The zero bit 

The value obtained by concatenating the values X and Y 

An optional field enclosed by brackets 

Contents of register or memory byte enclosed by parentheses 
Replace value on lefthand side of arrow with value on right- 


hand side of arrow 


CARRY BIT INSTRUCTIONS 


[LABEL: ] CODE 


| CODE DESCRIPTION 


(carry) <— _ 1 Set carry 


(carry) ~—— SS Complement carry 


Condition bits affected: Carry 
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SINGLE REGISTER INSTRUCTIONS 


Des 


Format: 
(LABEL: ] INR REGM 
(LABEL: ] DCR REGM 
(LABEL: ] CMA 
(LABEL: ] DAA 
Code Description 
INR (REGM) (REGM) + 1 
DCR (REGM) (REGM) - 1 
CMA (A) < (A) 
DAA Lf (Ap-A3) > 9 or (aux. carry = 1, 
(A) (A) +6 
Then if (Aq-Az) > 9 or (carry)= 
1 (A) = (A) + 6 *24 
Condition bits affected: INR,DCR : Zero, 
CMA : None 
DAA : Zero, 
NOP INSTRUCTION 
Format: 
[LABEL: ] NOP 


cription 


No operation 


Increment register REGM 
Decrement register REGM 
Complement accumulator 
Convert accumulator 
contents to form 


two decimal 
digits 


sign, parity 


sign, parity, carry, aux. carry 


Condition bits affected: 


None 
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DATA TRANSFER INSTRUCTIONS 


Format: 
(LABEL: ] MOV DST,SRC 
(LABEL: ] CODE RP 


NOTE: SRC and DST not both = M 


NOTE: RP = B or D 


Code | Description | 


Load register DST from register SRC 


Store accumulator at memory 
location referenced by the specified 
register pair 


Load accumulator from memory 
location refereced by the specified 
register pair 


Condition bits affected: None 


REGISTER OR MEMORY TO ACCUMULATOR INSTRUCTIONS 


Format: 
(LABEL: ] CODE REGM 

Code Description 

ADD (A) — (A) + (REGM) Add REGM to accumulator 

ADC (A) ¢ ss (A) + (REGM)+(carry) Add REGM to accumulator 
with carry 

SUB (A) C (A) - (REGM) Subtract REGM from accumulator 

SBB (A) < (A)-(REGM)-(carry) Subtract REGM from accumulator 
with borrow 

ANA (A) ¢< (A) AND (REGM) AND accumulator with REGM 

XRA (A) cane =(A) XOR (REGM) EXCLUSIVE-OR accumulator 


with REGM 
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Code Description 


ORA (A) ¢— (A) OR (REGM) OR accumulator with REGM 
CMP Condition bits set by (A)-(REGM) Compare REGM with 
accumulator 


Condition bits affected: 


ADD, ADC, SUB, SBB: Carry, Sign, zero, parity, aux. carry 

ANA, XRA, ORA: Sign, zero, parity. Carry is zeroed. 

CMP: Carry, Sign, zero, parity, aux. carry. Zero set if (A)=(REGM) 
Carry reset if (A) < (REGM) 
Carry set if (A)> (REGM) 


ROTATE ACCUMULATOR INSTRUCTIONS 


Format: 


(LABEL: ] CODE 


Description 


(carry) ¢ Agr Anyre AyrAg e Aj Set carry =A7, rotate 
accumulator left 


RRC (carry) z=. Apr An & An41°A7 <— *%o Set carry =Ap, rotate 
accumulator right 

RAL An+1 € An, (carry) ¢A7/Ao ~ (carry) Rotate accumulator 
left through the carry 

RAR And ADEL! (carry) ¢—AgrA, <_ (carry) Rotate accumulator 


right through carry 


Condition bits affected: Carry 


REGISTER PAIR INSTRUCTIONS 


Format: 
(LABEL: ] CODE1 RP 
(LABEL: ] CODE2 


Note: For PUSH and POP, RP=B,D,H or PSW 
For DAD, INX, and DCX, RP=B,D,H, or SP 


Spl 


Codel Description 


PUSH ((SP)-1) ¢—_(RP1), ((SP)-2) ¢_ (RP2), 


POP (RPI)e ((P)+H), (RP2)<- ((SP)), 


(SP)g (SP)+2 


DAD (HL)g —__(HL) + (RP) 
INX CRP) 2 (RP) +1 
DCX (RP) ¢ (RP)-1 


Save RP on the 

stack 

RP=A saves accumulator 
and condition bits. 
Restore RP from 

the stack 

RP=A restores accumulator 


and condition bits. 
Add RP to the 16-bit 


number in H and L. 
Increment RP by 1 
Decrement RP by 1 


Code2 Description 


XCHG (H)e-5(D), (L) e> (E) 
XTHL (L)e 3((SP)), (H)e ((SP)+1) 
SPHL (SP) 2 — (H)¢ (DL) 


Condition bits affected: 


PUSH, INX, DCX, XCHG, ‘XTHL, SPHL: None 


Exchange the 16 bit 
number in H and L with 
that in D and E. 
Exchange the last 
values saved in the 
stack with H and L. 
Load stack pointer from 
H and L. 


POP : If RP=PSW, all condition bits are restored from the stack, otherwise 


IMMEDIATE INSTRUCTIONS 


none are affected. 
DAD > Carry 
Format: 
(LABEL: ] LX1 
(LABEL: ] MV1 
-or- 
(LABEL: ] CODE 


Note: RP=B,D,H, or SP 


RP, DATA16 


REGM, DATA 


CODE | DESCRIPTION | 


LXI (RP)¢—— DATA 16 Move 16 bit immediate Data 
into RP 

MVI (REGM) e —___ DATA Move immediate DATA into REGM 

ADI (A)e-—-(A) + DATA Add immediate data to accumulator 

ACI (A) (A) + DATA + (carry) Add immediate data to accumulator 
with carry 

SUI (A)e——__ (A) - DATA Subtract immediate data from 
accumulator 

SBI (A)e- (A) - DATA - (carry) Subtract immediate data from 
accumulator with borrow 

ANI (A)e (A) AND DATA AND accumulator with immediate 
data 

XRI (Ade (A) XOR DATA EXCLUSIVE-OR accumulator with 
immediate data 

ORI (A)=—_(A) OR DATA OR accumulator with immediate 
data 

CPI Condition bits set by (A)-DATA Compare immediate data with 
accumulator 


Condition bits affected: 


LXI, MVI: None 

ADI, ACI, SUI, SBI: Carry, sign, zero, parity, aux. carry 

ANI, XRI, ORI: Zero, sign, parity. Carry is zeroed. 

GPL: Carry, Sign; zero, parity, aux. carry. Zero is set if (A)= DATA 
Carry reset if (A) < DATA 
Carry set if (A) > DATA 


DIRECT ADDRESSING INSTRUCTIONS 


Format: 


[LABEL: ] CODE ADDR 


Store accumulator at location 
ADDR 


LDA Load accumulator from location 
ADDR 

SHLD (ADDR) <(L), (ADDR+1)¢ (3) Store L and H at ADDR and 
ADDR+1 

LHLD (L) (ADDR) » (H) < (ADDR+1) Load L and H from ADDR and ADDR+1 


Condition bits affected: None 
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a | 


JUMP INSTRUCTIONS 


Format: 
[LABEL: ] PCHL 
(LABEL: ] CODE ADDR 
CODE | DESCRIPTION | 


PCHL (PC) ¢—_(HL) Jump to location specified by 
register H and L 

JMP (PC) ¢ ADDR Jump to location ADDR 
Jc Tf (carry) © ly (PCc)e— ADDR 

If (carry) = 0, (PC) e— (PC) +3 Jump to ADDR if carry set 
JNC If (carry) = 0, (OC) ¢ ADDR 

If (carry) = 1, (PC) e (PC)+3 Jump to ADDR if carry reset 
JZ If (zero) = 1, (PC) ¢ ADDR 

If (zero) = 0, (PC) ~< (PC)+3 Jump to ADDR of zero set 
JNZ If (zero) = 0, (PC) < ADDR 

If (zero) = 1, (PC) é (PC) +3 Jump to ADDR if zero reset 


JP If (sign) = 0, (PC) «— ADDR ; 
If (sign) = 1, (PC) < (PC)+3 Jump to ADDR if plus 
JM If (sign) = 1, (BPC) < ADDR 
rf (Sign) =e, (PC) — (C13 Jump to ADDR if minus 
JPE if (partty)= 1, (Pc) 4 ApoR 
If (parity)= 0, (PC) ~~ —(PC)+3 Jump to ADDR if parity even 
JPO If (parity)= O, (PC) <—ADDR 
Te (paritey)= 1). (Pe) PC) as Jump to ADDR is parity odd 


Condition bits affected: None 
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CALL INSTRUCTIONS 


Format: 


[LABEL: ] CODE ADDR 


| CODE | DESCRIPTION 


((6P) 1) (PCW) > CSP) 2) 2. (Pel), (SPie (SP) ray eC) ~ = BDoR 
call subroutine and push return 
address onto stack 


(carry) C(SP) =i) <= (PCH) ((SP)=2) e= (PEL), (pr) eo (SP) te, 
(PC)~_ ADDR 
(carry) (PC)<_ (PC) +3 Call subroutine if carry set 


(carry) ((SP)-1 ¢~— (PCH), ((SP)-2)<— (PCL), (SP) <-— (SP)+2, 
(PC) <_ ADDR 
(carry) (PC) e— (PC)+3 Call subroutine if carry reset 


(zero) ((SP)-1)- (PCH), ((SP)-2) < — (PCL), (SP) e— (SP)+2, 
(PC) —— ADDR 
(zero) (BE). -e=.(PC)E3 Call subroutine if zero set 


(zero) ((SP)=1) <— (BCH), ((SP)=2).2— (Pcl), (SP) 2. (shire; 
(PC) ~_ ADDR 
(zero) (Bc) <= (Po)+3 Call subroutine if zero reset 


(sign) ({(SP)=1).<—(PCH), ((SP)=2) @. (PCL), (SP) <— (SP) +2, 
(PC) ¢- ADDR 
(sign) (PC) <- (PC) +3 Call subroutine if sign plus 


(sign) ((SP)-l)e (PCH), ((SP)-2) <- (PCL), (SP) €—(SP)+2, 
(PC) ~ ADDR 


(sign) (PC) 2 (BC)+3 Call subroutine if sign minus 


(parity)= ((SP)-1) <- (PCH), ((SP)-2) <— (PCL), (SP) <—(SP)+2, 
(PC) ¢- ADDR 
(parity) = (PC) <— (PC)+3 Call subroutine if parity even 


(parity) = ((SP)-1) <_ (PCH), ((SP)-2) <— (PCL), (SP) e (SP)+2, 
(PC) <~— ADDR 
(parity)= (PC) 2 (PE) 3 Call subroutine if parity odd 


Condition bits affected: None 
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RETURN INSTRUCTIONS 


Format: 


(LABEL: ] CODE 


DESCRIPTION 


(PCL) e ((SP)), (PCH) <— ((SP)+1); (SP) <—(SP)+2 
Return from subroutine 


If (carry) (PCH) <— ((SP)+1), (SP) e— (SP)+2 
If (carry) ( Return if carry set 


If (carry) (Bony 2G (PCH) < ((SP)+1), (SP) e— (SP)+2 


SP)), 
If (carry) (BC) <=. (BC)+3 Return if carry reset 


If (zero) , (PCL) ¢— ((SP)), (PCH) <— ((SP)+1), (SP) ¢— (SP)+2 
If (zero) 7 (PC) 2—. (PC) +3 Return if zero set 


If (zero) (PC) <— (PC)+3 Return if zero set 


If (sign) = (PCL) e— ((SP)), (PCH) — ((SP)+1), (SP) <_ (SP)+2 
(sign) = 0, (PC) <— (PC) +3 Return if iainus 


(sign) = 0, (PCL)<— ((SP)), (PCH) e-((SP)+1), (SP) <— (SP)+2 
(sign) = (PC) 2 (PC) +3 Return if plus 


(PCL) 2=((8P)), (PcH)<— (C(SP)+1), (SP) <—(SP)+2 
(PC) <=. (PC) . (PC)+3 Return if parity even 


(parity)=0, (PCL) <— ((SP)), (PCH) <—((SP)+1), (SP) <— (SP)+2 
(parity)=1, (PC) e— (PC)+3 Return if parity « 74 


Condition bits affected: None 


RST INSTRUCTION 


Format: 
(LABEL: ] RST EXP 


Note: O EXP 7 


DESCRIPTION 


((SP)-1) <— (PCH), ((SP)-2) <-(PCL), (SP) q— (SP)+2 
(PC) <- 0000000000EXP000B Call subroutine at address 
specified by EXP 


Condition bits affected: None 
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INTERRUPT FLIP FLOP INSTRUCTIONS 


Format: 
(LABEL: ] CODE 
CODE DESCRIPTION 
EI (INTE) <<———.. I Enable the interrupt system 
DI ) (INTE) ~— 0 Disable the interrupt system 


Condition bits affected: None 


INPUT/OUTPUT INSTRUCTIONS 


Format: 


(LABEL: ] CODE EXP 


DESCRIPTION 


(A) input device Read a byte from device EXP into 
the accumulator 


OUT output device <—_ (A) Send the accumulator contents to 


device EXP 


Condition bits affected: None 


HLT INSTRUCTION 


Format: 
(LABEL: ] HLT 


DESCRIPTION 


Instruction execution halts until 
an interrupt occurs. 


Condition bits affected: None 
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PSEUDO - INSTRUCTIONS 


ORG PSEUDO - INSTRUCTION 


Format: 


ORG EXP 


P eertption 


LOCATION COUNTER ¢——— EXP Set Assembler location 
counter to EXP 


EQU PSEUDO - INSTRUCTION 
Format: 


NAME EQU EXP 


| eseription 


NAME <——_________ EXP Assign the value EXP 
to the symbol NAME 


END PSEUDO - INSTRUCTION 
Format: 


END 


| meseription 


End the assembly. 
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APPENDIX B 


--INSTRUCTION EXECUTION TIMES AND BIT PATTERNS-- 


This appendix summarizes the bit patterns and number of time states 
associated with every 8080 CPU instruction. 


When using this summary, note the following symbology: 


1) DDD represents a destination register. SSS represents a 
source register. Both DDD and SSS are interpreted as 
follows: 

DDD or SSS Interpretation 

000 Register B 

OOl Register C 

010 Register D 

O11 Register E 

100 Register H 

101 Register L 

110 A memory register 
lll The accumulator 

2) Instruction execution time equals number of time periods 


multiplied by the duration of a time period. 

A time period may vary from 480 nanosecs to 2 microsec. 

When two numbers of time periods are shown (eg. 5/11), it 
means that the smaller number of time periods will be required 


if a condition is not met, and the larger number of time periods 
will be required if the condition is met. 
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11/17 
11/17 
T/A, 
11/17 
11/17 
11/17 
11/17 
10 
5/11 
5/11 
5/11 
5/il 
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5/1l 
5/11 
5/11 
11 
10 
10 
10 
10 
10 
10 
iL 
M7. 
11 
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10 
10 
10 
10 
13 
13 
18 
10 
10 
10 
10 
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Number of Time Periods 
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APPENDIX C 


HEXADECIMAL PROGRAM TAPE FORMAT 


The hexadecimal tape format used by the Intecolor® 8001 system is a 
modified memory image, blocked into discrete records. Each record 
contains record length, record type, memory address, and checksum 


information in addition to data. 


is as follows: 


Frame O 


Frames 1,2 
(0-9,A-F) 


Frames 3 to 6 


Frames 7,8 


Frames 9 to 9+2* (Record 
Length) - 1 


A frame by frame description 


Record Mark, Signals the start of 
a record. The ASCII character 
colon (":" HEX 3A) is used as the 
record mark. 


Record Length. Two ASCII characters 
representing a hexadecimal number 

in the range 0 to 'FF'H (0 to 255). 
This is the count of actual data 
bytes in the record type or check- 
sum. A record length of O indicates 
end of file. 


Load Address. Four ASCII characters 
that represent the initial memory 
location where the data following 
will be loaded. The first data byte 
is stored in the location pointed 

to by the load address, succeeding 
data bytes are loaded into 

ascending addresses. 


Record Type. Two ASCII characters. 
Currently all records are type 0, 
this field is reserved for future 
expansion. 


Data. Each 8 bit memory word is 
represented by two frames containing 
the ASCII characters (0 to 9, A to F) 
to represent a hexadecimal value 0 
to *FF'H (0° to 255). 
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Frames 94+2* (Record Length) to 
94+2* (Record Length) +1 


OE EE SE en ee ee ea ee, 


Checksum. The checksum is the 
negative of the sum of all 8 bit 
bytes in the record since the 
record mark (":") evaluated 
modulus 256. That is, if you 
add together all the 8 bit bytes, 
ignoring all carries out of an 
8-bit sum, then add the checksum, 
the result is zero. 


Example: If memory locations 1 through 3 contain 53F8EC, the format 
of the hex file produced when these locations are punched is: 


: 030001005 3F8ECC5 


Note: This format is also known as the Intel format. 
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